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MASSBUS 
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DECtape 
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DIBOL 
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EduSystem 
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FLIP CHIP 
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SBI 


DECnet 
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PDT 


DATATRIEVE 


TRAX 
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3.3 Physical Device Names 



When you request services from the monitor, you must sometimes specify a 
peripheral device. You can specify devices by means of a standard two-char- 
acter physical device name. Table 3-1 lists each name and its related device. 
If you do not specify a unit number for devices with more than one unit, the 
system assumes unit 0. 



Table 3-1: Permanent Device Names 
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Permanent Name 


I/O Device 


CR: 


CRll/CMll Card Reader 


CTn: 


TAll Cassette in is or 1) 


DI)n: 


TU58 DECtape II (n is an integer in the range 0-3) 


DK: 


The default logical storage device for all files (DK: is initially the 
same as SY:) 


DKn: 


The specified! unit of the same device type as the system device 


DI.n: 


RLOl, RL02 Disk (n is an integer in the range 0-3) 


DMn: 


RK06, RK07 Disk {n is an integer in the range 0-7) 


DI»n: 


RP02, RI^03 Disk (n is an integer in the range 0-7) 


DSn: 


RJS03/4 Fixed-Head Disks (n is an integer in the range 0-7) 


DTn: 


DECtape {n is an integer in the range 0-7) 


DXn: 


RXOl Diskette in is an integer in the range 0-3) 


DYn: 


RX02 Diskette in is an integer in the range 0-3) 


LP: 


Line Printer 


LS: 


Serial Line I'rinter (a hard copy output device connected to a DLll 
interface) 


MMn: 


TJU16/TU4J) (industry -compatible) Magtape (n is an integer in the 
range 0-7) 


MQ: 


Message queue pseudo-device for inter-job communication under the 
FB monitor. 


MSn: 


TSll Magtajje in is an integer in the range 0-7) 


MTn: 


TMll/TMAl l/TS03/'i'E16 (industry-compatible) Magtape (w is an 
integer in the range 0-7) 


NL: 


Null device 


PC: 


PC 1 1 Combined High-Speed Paper Tape Reader and Punch 


PDn: 


The mass storage volume for the PDT-130/150 intelligent terminal. 
Volumes are DECtape II or single-density diskettes (n is either 
or 1). 


RF: 


RFll Fixed-Head Disk Drive 


RKn: 


RK05 Disk Cartridge Drive in is an integer in the range 0-7) 


SY: 


The default logical system device; the device and unit from which the 
system is bocitstrapped 


SYn: 


The specified unit of the same device type as SY: 


TT: 


Console Terminal Keyboard and Printer 


XTn: 


Down-line load handler (MRRT-11 only) 
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In addition to using the permanent names shown in Table 3-1, you iian 
assign logical names to devices. A logical name takes precedence over a 
physical name and thus provides device independence. With this feature, 
you do not have to rewrite a program that is coded to use a specific device if 
the device becomes unavailable. You associate logical names with physical 
devices by using the ASSIGN command, which is described in Section 4.4. 



3.4 File Names and File Types 



You can reference files symbolically by a name of one to six alphanumtjric 
characters (followed, optionally, by a period and a file type of up to three 
alphanumeric characters). No spaces or tabs are allowed in the file nam<j or 
file type. The file type generally indicates the format or contents of a file:. It 
is good practice to conform to the standard file types for RT— 11. If you do not 
specify a file type for an input or output file, most system programs use or 
assign an appropriate default file type. Table 3-2 lists the standard file 
types used in RT-11. 



Table 3-2: 


Standard File Types 


File Type 


Meaning 


.BAG 


Compiled BASIC program 


.BAD 


Files with bad (unreadable) blocks; you can assign this file type whenever 
bad areas occur on a device. The .BAD file type makes the file permanent in 
that area, preventing other files from using it and consequently becoming 
unreadable 


.BAK 


Editor backup file 


.BAS 


BASIC source file (BASIC input) 


.BAT 


BATCH command file 


.CND 


System generation conditional file 


.COM 


Indirect command file 


.CTL 


BATCH control file generated by the BATCH compiler 


.CTT 


BATCH internal temporary file 


.DAT 


BASIC or FORTRAN data file 


.DBL 


DIBOL source file 


.DDF 


DIBOL data file 


.DIF 


SRCCOM output file 


DIR 


Directory listing file 


.DMP 


DUMP output file 


.FOR 


FORTRAN IV source file (FORTRAN input) 


.LDA 


Absolute binary (load image) file (optional linker output) 


.LOG 


BATCH log file 


.LST 


Listing file (MACRO, FORTRAN, LIBR, or DIBOL output) 


.MAC 


MACRO source file (MACRO or SRCCOM input, LIBR input and output) 


.MAP 


Map file (linker output) 



(continued on next p'age) 
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Chapter 4 
Keyboard Commands 



Keyboard commands allow you to communicate with the RT-11 system. 
You enter keyboard commands at the terminal in response to the keyboard 
monitor dot (.), and the operating system invokes the appropriate system 
programs to service these commands. 

This chapter uses some symbolic conventions to describe the monitor com- 
mand language. The preface to this manual contains a more detailed list of 
the symbolic conventions used throughout the manual. You should familiar- 
ize yourself with the symbols and their meaning before reading this chapter. 



4.1 Command Syntax 



Th(} system accepts commands as either: (1) a complete string containing all 
the information necessary to execute a command, or (2) as a partial string. 
In the latter case the system prompts you to supply the rest of the informa- 
tion. Terminate each command with a carriage return. 

Th(j general syntax for a command is: 

command[/option. . .] input-filespec[/option. . .] 
output-filespec[/option. . .] 

or 

commandr/option...] 

promptl? input-filespec[/option...] 

prompt2? output-filespeic[/option. . .] 

where: 

command is the command name 

/option represents a command qualifier that specifies the 

exact action to be taken. Any option you supply 
immediately following the command applies to the 
entire command string 

prompt represents the keyboard monitor prompt for more 

inforreiation. The keyboard monitor prints an appro- 
priate prompt only if you omit input and/or output 
file or device specifications in the initial command 
line (P'Tote that not all keyboard monitor commands 
print prompts.) 



.^_ J input-filespec represents the file on which the action is to be taken 
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/option represents a file qualifier that specifies more detailed 

information about that particular file or action to be 
taken 

output-filespec represents the file that is to receive the results of the 
operation 

/option represents a file qualifier that specifies more detailed 

information about that particular file or action to be 
taken 

In the alphabetical listing of keyboard monitor commands in Section <L4, 
each command begins with a graphic presentation of the syntax involved 
(see Figure 4-1 for an illustration of a typical command). These preserita- 
tions provide a ready-reference list of the options that the commands accespt, 
as well as information that makes the commands easier to use. The follow- 
ing list describes the conventions used. 

1. Capital letters represent command names or options, which you must 
type as shown. (Abbreviations are discussed later in this section.) 

2. Lower-case letters represent arguments or variables, for which you 
must supply values. For options that accept numeric arguments, the 
system interprets the values as decimal, unless otherwise stated. Some 
values, usually memory addresses, are interpreted as octal; these cases 
are noted in the accompanying text. 

3. Square brackets ([]) enclose options; you can include the item that is 
enclosed in the brackets or you can omit it, as you choose. If a vertical 
list of items is enclosed in square brackets, you can combine the options 
that appear in the list. However, an option set off from the others by 
blank lines (see /BOOT and /DEVICE in Figure 4-1) indicates that you 
cannot combine that option with any other option in the list. 

4. Braces ({ }) enclose options that are mutually exclusive. You can choose 
only one option from a group of options that appear in braces. 

5. It is conventional to place command options (those qualifiers that apply 
to the entire command line) immediately after the command. However, 
it is also acceptable to specify a command option after a file specifica- 
tion. File options (those that qualify a particular file specification) must 
appear in the command line directly after the file to which they apjply. 
The graphic representation of each command shows which options are 
file qualifiers, and whether they must follow input or output file 
specifications. 

6. A line such as [NOJQUERY represents two mutually exclusive options: 
QUERY and NOQUERY. 

7. Underlining indicates default options, that is, the option that the sys- 
tem uses if you do not specify any choice of action. 
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Figure 4-1: Sample Command Syntax Illustration 



COPY 


/BOOT |:vall 

/DEVICE 
/FILES 

r /ASCII 1 

/BINARY 
I /IMAGE J 
/CONCATENATE 
/EXCLUDE 
/IGNORE 
/[NO] LOG 
/NEWFILES 
/PACKED 
/PREDELETE 
/[N0| QUERY 
/INOl REPLACE 
/SETDATE 
/SLOWLY 
/SYSTEM 
/WAIT 


( SP ) Input-lllespcics 


/DOS I/OWN ER:[nnn,nnn]r 

/INTERCHANGE 

/POSITION:!! 

/TOPS 

/END:!! 

/START;!! 


( SP )outputlllespec 


r/ALLOCATE:size 1 
/DOS 

/INTERCHANGE[:slze| 
/POSITION:!! 
./START:!! J 





A iilespec represents a specific file and the device on which it is stored. Its 
syntax is: 

dev:filnam.typ 

where: 

dev: represents either a logical device name or a physical device 
name, which is a two- or three-character name from Table 
3-1 

filnam represents the one- to six-character alphanumeric name of 
the file 

.typ represents the one- to three-character alphanumeric file 
type, some of v/^hich are listed in Table 3-2 

There are several ways to indicate the device on which a file is stored. You 
can explicitly type the device name in the file specification: 

i:ixi;test.i...st 

You can omit the device name: 

TEST . L.ST 

In this case, the system assumes that the file is stored on device DK:. 



4.1 .1 Factoring File Specifications 

If you want to specify several files on the same device, you can use factoring. 
That is, you can enclose multiple file names in parentheses, as in the follow- 
ing example: 

DTO J ( TEST . LST » TESTA , LST » TESTB . LSI ) 
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The command shown above has the same meaning as and is easier to use 
than the next command: 

DTO J TEST . LST j DTO : TESTA . LST f DTO { JESlh . LST 

When you use factoring the device name outside the parentheses applies to 
each file specification inside the parentheses. Without factoring, the system 
interprets each file specification to be DK:filespec unless you explicitly spec- 
ify another device name. 

Factoring is useful for complicated command lines. It is a general method of 
string replacement that you can use in many different situations. The mon- 
itor uses the following algorithm to interpret command lines that require 
factoring: 

Format of the command line you type: 

Dl Tl (T3 D3 T4 D4...Tn) T2 D2 

Format of the command line after the monitor performs the factoring: 

Dl T1T3T2 D3 T1T4T2 D4...TlTnT2 D2 

In the skeleton examples shown above, the symbols have the following 
meaning: 

D represents a delimiter 

Dl is one of the following delimiters: 

comma 

space 

beginning of line 

D2 is one of the following delimiters: 

comma 
space 
slash 
end of line 

D3 through Dn can be one of the following delimiters: 

comma 
space 

T represents a text string 

The following example shows how a command line expands after factoring. 
Note that the /SYSTEM option appears only once in the resulting out]put 
line. 



Original command line: 



COPY nx : F" II... ( 1 r 2 » 3 ) . SYS/SYSTEM RKl X 
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Resulting command line (aft<ir factoring): 

COF'Y nXJFILl .SYSi.i:iXJFIL.2.SrSrriX;F:i:L3. SYS/SYSTEM RKl : 

NOTE 

There is a restriction on the use of factoring. The command 
string that results from the expansion of the line you enter 
must not exceed 80 characters in length. If you use six- 
character file names and you also use factoring, specify only 
five files in a command line. 



4.1 .2 File Type Specification 

If you omit the file type in a file specification, the system assumes one of a 
number of defaults, depending on which command you issue. The MACRO 
command, for example, assumes a file type of .MAC for the input file specifi- 
cation, and the PRINT command assumes .LST. Some commands (such as 
COPY) do not assume a particular file type, and may assume a wildcard 
default (see Section 4.2). If you need to specify a file that has no file type in a 
command that assumes a default file type, type a period after the file name. 
For example, to run the file called TEST, type: 

RUN TEST. 

If you omit the period after the file name, the system assumes a .SAV file 
type and tries to execute a file called TEST.SAV. 

You can enter up to six input files and up to three output files for some com- 
mands. If the command string does not fit on one line of your terminal, use 
the hyphen (-) continuation character as the last character in the line to 
break the string into smallei- sections. Use a carriage return to terminate 
the command string. Note that there is still a limit of 80 characters for an 
expanded command line. 

Some of the command and file options are mutually exclusive. You should 
avoid using combinations of options that give contradictory instructions to 
the system. For example, 

. DELETE/aUERY/NOaUERY TEST .. LST 

This command is not meaningful. Some mutually exclusive options are less 
obvious; these are noted, where necessary, in the list of options following 
each command and are enclosed by braces ({ }) in the graphic representa- 
tions of the command syntax. 



4.1.3 Abbreviating Keyboard Commands 

Although the keyboard monitor commands are all English-language words 
and therefore easy to use, it can become tedious to type words like CROSS- 
REFERENCE and ALLOCATE frequently. You can use as abbreviations 
the minimum number of characters that are needed to make the command 
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or option unique. Table B-1 in Appendix B lists the minimum abbreviations 
for the commands and options. Note also that in Section 4.4, the abbre\ia- 
tions are in red. 

An easy way to abbreviate the commands, and one that is always correct, is 
to use the first four characters or the first six characters if the qualifier 
starts with NO. For example: 

CONCATENATE can be shortened to CONC 

NOCONCATENATE can be shortened to NOCONC 

The system prints an error message if you use an abbreviation that is not 
unique. For example, typing the following command produces an eriror, 
because C could mean COPY or COMPILE. 

C TESTJ...ST 



4.1.4 Keyboard Prompts 

The prompting form of the command may be easier for you to learn if you are 
a new user. If you type a command followed by a carriage return, the syst;em 
prompts you for an input file specification: 

COPY/CONCATENATE 
From? 

You should enter the input file specification and a carriage return: 

DX I : < TEST . I... ST Y TESTA . LST ) 

The system prompts you for an output file specification: 

to ? 

You should enter the output file specification and a carriage return: 

1:1X2: TEST. LST 

The command now executes. 

The system continues to prompt for an input and output file specifica1;ion 
until you provide them. If you respond to a prompt by entering only a car- 
riage return, the prompt prints again. You can combine the normal form of a 
command with the prompting form, as this example shows: 

. COPY ABC . I... ST 
To ? DEF.LST 

The system always prompts you for information if any required part of the 
command is missing. You can also enter just an option in response to a 
prompt. The two following examples are equivalent. 



4-6 Keyboard Commands 



.COPY .COPY 

f-roiTi ? * . MAC/N01..00 From ? /NOLOG 

To ? *.BAK From ? *.MAC 

To ? JK.BAK 



4.2 Wildcards 



Some commands accept wildcards (% and *) in place of the file name, file 
type, or characters in the file name or file type. The system ignores the con- 
tents of the wild field and selects all the files that match the remaining 
fields. 

An asterisk (*) can replace a file name: 

*.HAC 

The system selects all files on device DK: that have a .MAC file type, regard- 
less of their name. 

An asterisk (*) can replace a iile type: 

TEST,* 

The system selects all files on device DK: that are named TEST, regardless 
oftheir file type. 

An asterisk (*) can replace both a file name and a file type: 

The system selects all files on device DK:. 

An embedded asterisk (*) can replace any number of characters in the input 
file name or file type: 

MB. mm: 

The system selects all files on device DK: with a file type of .MAC whose file 
names start with A and end with B. For example, AB, AXB, AXYB, etc., 
would be selected. 

The percentage symbol (%) is always considered to be an embedded wild- 
card. It can replace a single character in the input file name or file type: 

A'/B . MAC 

The system selects all files on device DK: with a file type of .MAC whose file 
names are three characters long, start with A, and end with B. For example, 
AXB, AYB, AZB, etc., would be selected. 

Table 4—1 lists commands that support wildcards. 
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Table 4-1: Commands Supporting Wildcards 



Command 


Specification | 


Input File 


Output File 


COPY 


X 


X 


DELETE 


X 




DIRECTORY 


X 




HELP 


X 




PRINT 


X 




RENAME 


X 


X 


TYPE 


X 





For commands that support wildcards the system has a special way of inter- 
preting the file specifications you type. You can omit certain parts of the 
input and output specifications, and the system assumes an asterisk (*) for 
the omitted item. Table 4-2 shows the defaults that the system assumes for 
the input and output specifications of the valid commands. 

Table 4-2: Wildcard Defaults 



Command 


Default 


Input 


Output 


COPY, RENAME 
DIRECTORY 
PRINT, TYPE 

DELETE 


* * 

DK:*.* 
*.LST 
filnam.* 


* * 



For example, if you need to copy all the files called MYPROG from DIK: to 
DXl:, use this command: 

.COPY/NOQUERY MYPFJOG DXl J 

The system interprets this command to mean: 

. COPY/NOQUERY DK ; MYPROG . * DX J. t * . * 

The system copies all the files called MYPROG, regardless of their file type, 
to device DXl: and gives them the same names. 

If you need a directory listing of all the files on device DK:, type the follow- 
ing command: 

.DIRECTORY 

The system interprets this command to mean: 

.DIRECTORY DKJ*.* 
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To list on the printer all the files on device DK: that have a .LST file type, 
use this command: 

.PRINT . dk: 

The system interprets this command to mean: 

.PRINT »KS*.I...ST 

To delete all the files on device DK: called MYPROG, regardless of their file 
type, use this command: 

. tiELETE/NOOUERY MYPROG 

The system interprets this to mean: 

. riELETE/NOQUERY DK t MYPROG . ^< 

You can use the SET WILDCARDS EXPLICIT command (described in Sec- 
tion 4.4) to change the way thei system interprets these commands. 



4.3 Indirect Files 



You can group together as a file a collection of keyboard commands that you 
want to execute sequentially. This collection is called an indirect command 
file, or indirect file. Indirect files are best suited to perform tasks that 
require a significant amount of computer time and that do not require your 
supervision or intervention. Any series of commands that you are likely to 
type often can also run easily as an indirect file. The indirect file concept is 
similar to BATCH processing. Although indirect files lack some of the capa- 
bilities of BATCH, they are easier to use, use the same commands as normal 
operations, and generally require less memory overhead than the BATCH 
processor. (RT-11 BATCH is described in Appendix A of this manual.) This 
section describes how to create indirect files and how to execute them. 



4.3.1 Creating Indirect Fiies 

Create an indirect file by using the EDIT/CREATE command described in 
Section 4.4. It is conventional to use a .COM file type for an indirect file, but 
you can choose any file name that you wish. Structure the lines of text to 
look like keyboard input, placing one command on each line of the file and 
terminating each line with a carriage return. Do not include the prompt 
character (.) in the line. Any ktjyboard monitor command you can type at the 
terminal you can also include in an indirect file. The following file, for 
example, prints the date and time, and creates backup copies of all FOR- 
TRAN source files: 

DATE 
TIME 
COPY )l<.FOR *.EiAK 

Control returns to the monitor at the console terminal after this indirect file 
executes. 
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In addition to using the keyboard monitor commands, you can also run one 
of the RT-11 system utility programs in an indirect file. In this case, struc- 
ture your input to conform to the Command String Interpreter syntax 
described in Chapter 6. Do not include the CSI asterisk (*) in any line that 
provides input or output to a utility program. The following file starts the 
directory system utility program and lists the directory of two devices on the 
line printer. 

R ri:LR 
lp::=:c;to5/c;3 

"C 

Note that the last command line is 'C. This is not the standard CTRL/C 
sequence you enter by holding down the CTRL key and typing a C. Rather, 
it is a readable character sequence that consists of two separate characters: 
a circumflex (uparrow) followed by a C. This sequence represents CTRL/C in 
indirect files. This sequence terminates the directory program so that con- 
trol returns to the monitor when the indirect file finished executing. Other- 
wise, the directory program would be left waiting for input from the console 
terminal when the indirect file finished executing. 

Remember to terminate the last command line with a carriage returiti, as 
you would any other line. 

NOTE 

If you have a small (12K) configuration or a very large 
indirect command file, use frequent CTRL/Cs in your 
indirect files. When the system processes an indirect file, it 
first places each line in a special memory buffer. This mem- 
ory buffer must expand to accommodate each line in an 
indirect file, and if there are too many lines before the sys- 
tem reaches a CTRL/C, the processor's memory area may 
become filled. Placing a CTRL/C every ten or so lines avoids 
this problem. 

Some commands normally require a response from you as they execute. The 
INITIALIZE command, for example, prints the Are you sure? message: and 
waits for you to type Y and a carriage return before it executes. The 
DELETE command also requests confirmation from you before it deletes a 
file. There are three ways to control interaction with the executing com- 
mand. One way is to use the /NOQUERY option on each command that 
allows it. This option suppresses the confirmation messages entirely Avhen 
you use the command in an indirect file. 

Another method of interacting applies to a command like DELETE. This 
command can have a variable number of confirmation queries, especially if 
you use a wildcard in the file specification. This type of command accepts 
your responses directly from the terminal and allows you to make a decision 
before deleting each file. However, in this case the indirect file cannot oper- 
ate unattended. 
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There is yet another way tci deal with commands that require a response 
from you. Both the INITIALIZE and LINK commands have options that 
cause the system to prompt you for data. This section describes two methods 
of responding to these prompts, where more than just a Y response is 
required. The INITIALIZE command with the /VOLUMEID option permits 
you to specify a volume ID and owner name for a device. You can place your 
responses in the indirect file, as this example shows: 

]: N i: T I A I. :i: z E / N Q u i:;: R Y / V o i. u m i;:: id n t j 

TAPE A 
PAYROLL 

You can change the indirect file so that the prompts appear on the console 
terminal and you can type your responses there: 

I N :i: T ;i: A I... :r z e / n o q u e r^; y / v o i. . u m i;;: :i: d rrr ; 

'■'C 

The "C informs the system that the responses are to be entered at the termi- 
nal. Execution of the indirect file pauses until you enter the responses. 

Similarly, the LINK command lets you specify some data either in the 
indirect file or from the console terminal. The following example contains 
the response to the TRANSFER prompt. 

L I N K /JRAH S F l=: R M Y I-' R (3 !■ C) D T 
O.ODT 

You can specify the same information interactively, as this example shows: 

L INK/TRANSFER MYPROG > ODT 

The 'C informs the system that the response to the prompt is to be entered 
at the terminal. Execution of the indirect file pauses until you enter your 
response. 

You can specify overlays to the LINK command by either of these two meth- 
ods. The following indirect file links an overlaid program consisting of a root 
module and four overlay modules that reside in two overlay segments. 

l:i:nk /PROMPT root 
owo/oti 

0UR2/0,M 
0VR3/0;2 
0UR4/0S2// 

Note in the above example that two slashes (//) terminate the module list. 
You can also enter all or part of the overlay information interactively, as 
this example shows: 

LINK/PROMPT ROOT 

oyR:i./o::i. 
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The "C informs the system that more overlay information is to be entered 
from the terminal. Execution of the indirect file pauses when the system 
requires the information. Respond to the asterisk prompt by entering the 
overlay information. Terminate the last overlay line with two slashes (//). 
Execution of the indirect file then proceeds. Chapter 11 describes the LINK 
program and explains how to use overlays. 

If you need to link more than six modules, you can specify the extra modules 
on the next line in the indirect file, as this example shows: 

L.. I N K / P R a M F^' T F T 1... :l, v I" 1 1... 2 » F :i: I.. 3 y I-- 1 1... 4 > F I\.J5>fU..6 
FTI...7rF:tL8// 

Or, you can enter the extra modules from the terminal: 

I.. INK/PROMPT F I L 1 r F :i:i..2 y F 1 1..;? y F I L4 y F T L.5 y I" :i: 1.6 

Execution of the indirect file pauses until you enter the remaining module 
names. Remember to follow the last name with two slashes (//). 

You can include comments in an indirect file to help you document jour 
work. These comments do not print on the console terminal when the 
indirect file executes. You begin each line of comment with an exclama tion 
point (!). The system ignores any characters it finds between the exclama- 
tion point and the end of the current line. The following example shows an 
indirect file that contains comments. 



IINIIIRECT FILE 




HATE 


! PRINT DATE 


TIME 


! PRINT TIME 


RENAME *.MAC Xf.BAK 


ISAVE .MAC FILES 


(3PR0CES 


ICALL ANOTHER INDIRECT 1 


DIRECTORY 


ILIST DIRECTORY OF DK: 



ILE 



NOTE 

You cannot place in indirect files responses to prompts that 
result in destruction of data. For example, you cannot use 
the INITIALIZE command followed by a Y on the following 
line in an indirect file. Commands like INITIALIZE and 
DELETE require responses that you must enter at the ter- 
minal. (You can avoid the need for a response by using the 
/NOQUERY option.) 



4.3.2 Executing Indirect Files 

You can execute indirect files under the SJ monitor, or in the background 
area under the FB or XM monitor. 
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To execute an indirect file, spiecify a command string according to the follow- 
ing syntax: 



@filespec 
where: 



is the monitor command that indicates an indirect file 



filespec represents the name and file type of the indirect file, as 
well as the device on which it is stored. The default file 
type is .COM 

If you omit the device specification, DK: is assumed. If you specify any other 
block-replaceable device, th<3 monitor automatically loads the handler for 
that device. It is conventional to type the indirect file command directly in 
response to the monitor's prompt, as this example shows: 

However, you can place the indirect command anywhere in a keyboard mon- 
itor command string, as long as it is the last element in the string, not 
including comments. For example: 

.DELETE/NOQUERY eiCNDCT ! COMMENTS 

This is a valid command string. The first line of the file should contain the 
list of files to be deleted. In the example above, assume the first line of the 
indirect file is: 

*.BAK 

This is the command that will actually execute: 

DELETE/NOQUERY JK.BAK 

Check your indirect file carefully for errors before you execute it. When the 
monitor or any program that has control of the system encounters an illegal 
command line, or if an execution error of any kind occurs, that particular 
line does not execute properly. Execution of the indirect file does proceed, 
however, until any program that may be running relinquishes control to the 
monitor. Be careful of this if you run a system utility program in an indirect 
file, as this example shows: 

R F':i:f-' 
nxo;*.MAC/D 

"C 

PRINT DXO;*,I...S'( 



If device DXl: becomes full before all the files from DXO: are copied to it, the 
second line of the indirect file does not execute completely. Execution then 
passes to the next line and the system deletes all MACRO files from DXO:. 
The 'C returns control to the: monitor, which aborts the rest of the indirect 
file. This example shows that it is possible to destroy files accidentally 
be(;ause of the way indirect files execute. To be safe, use only keyboard mon- 
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itor commands in an indirect file. This way the monitor regains control al'ter 
each operation and can abort the indirect file as soon as it detects an erroi'. A 
better way to perform the same operations as the indirect file shown above is 
as follows: 

COPY Bxo;*.* Dx,i. ;*.* 

DELETi;:: DX0!*.HAC 
PRINT i:iXOI*.I..ST 

You can use the SET ERROR command, described in Section 4.4, to define 
the severity of error that causes an indirect file to stop executing. 

Normally, as each line of an indirect file executes, it echoes on the console 
terminal so that you can observe the progress of the job. However, you cian 
use the SET TT QUIET command, described in Section 4.4, to suppress this 
printout. In this case, only the prompting messages, if any, print. You can 
stop execution of an indirect file at any time by typing two CTRL/C chaiac- 
ters. Control returns to the monitor and you can enter a new command. You 
can also abort the indirect file by typing a single CTRL/C in response to a 
query or prompt. If you use an indirect file to execute a MACRO program, 
read the appropriate section in the RT-11 Programmer's Reference Manual 
to learn about certain restrictions on using the .EXIT call with indirect files. 

You can call another indirect file from within an indirect file. This procedure 
is called nesting. Restrict nesting to three levels of indirect files (see the 
RT-11 Installation and System Generation Guide for details on selecting the 
indirect file nesting depth). The following example shows two-level nesting. 
Assume a programmer types this command at the console terminal in 
response to the monitor's prompt: 

(3f:i:rst 

The file FIRST.COM contains these lines: 



DATE 
TIME- 
COPY *,MAC >t:.BAK 
(SSECOND 
PRINT C 

i:iiri:::ctory/prj:nter dk; 
iielete/noquery *.mac 



When this file executes it calls another indirect file, SEC0ND.COM, which 
contains this line: 

M A C R / C R S S R E F- E:: R E: N C E MBiC/LlSJ 

When file SEC0ND.COM finishes executing, control returns to file 
FIRST.COM, at the line following the indirect file specification. 
FIRST.COM then prints the contents of the file C.LST on the line printer, 
followed by a directory listing of device DK:. Then control returns to the 
monitor at the console terminal. 
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4.3.3 Startup Indirect Files 

Section 3.1 introduced the startup indirect command files: STARTS.COM 
(for SJ), STARTF.COM (for FB), and STARTX.COM (for XM). Each monitor 
automatically invokes its own indirect command file when you bootstrap the 
system, and you can modify these files to perform standard system con- 
figurations. Since many of th(3 system parameters are reset by a bootstrap 
operation (see the SET command, Section 4.4), you should use the startup 
indirect files to set the system parameters you normally use. For example, if 
you use the FB monitor and have a visual display console terminal that sup- 
ports hardware tabs, add the SET TT: SCOPE and SET TT: TAB commands 
to the file STARTF.COM. You could also include a SET TT: QUIET com- 
mand at the beginning of STARTF.COM and a SET TT: NOQUIET com- 
mand at the end to suppress extra type-out at bootstrap time. If you have a 
list of commands that you need to execute, regardless of the monitor you 
bootstrap, include these commands in a separate indirect file, such as COM- 
M0N.COM, and invoke this file from all three startup indirect files. The fol- 
lowing example shows a typical STARTF.COM file. 



se;:t its 


QUIET 


SET tt; 


SCOPE 


sk: r TT ! 


TAB 


eCOMMON 




SET tt; 


noqij:i:et 



!TURN OFF TTY PRINTING 



! PERFORM COMMON OPERATIONS 
!TURN ON TTY PRINTING 



If you use BATCH frequently, use a startup indirect file to assign devices 
and load handlers. You can also use the startup indirect files to run your 
own programs, set the date, or do other housekeeping chores. 



4.4 Keyboard Monitor Commands 

The keyboard monitor commands are your means of communicating with 
the system and controlling thei monitor. This section lists the keyboard mon- 
itor commands in alphabeticjil order. Each command description includes 
the command syntax, a table of valid options, and some sample command 
lines, as well as a general discussion of how to use the command. 

You can type almost all the commands to any of the three monitors. The 
exceptions are FRUN, SRUN, SUSPEND, and RESUME. These are not 
valid for the SJ monitor because they apply to foreground programs. 

Any reference to the background program applies also to the program run- 
ning under the SJ monitor. Any reference to FB operation also applies to the 
XM operation. 

NOTE 

Unless noted otherwise, all numeric values you supply to 
keyboard commands should be in decimal. 
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If you make a mistake in a command line, or if the system cannot peri'orm 
the action you request, an error message prints on your terminal. The error 
message indicates which error occurred; see the RT—11 System Message 
Manual for a more complete description of the error and for the recom- 
mended action to take. The error message also indicates which system util- 
ity program detected the error. For example, if your keyboard monitor 
command line contains a syntax error, the keyboard monitor prints an error 
message. If the utility program the keyboard monitor invokes cannot exe- 
cute a command, that utility prints the error message. 

RT—11 permits you to remove some of the monitor commands at system gen- 
eration time. If you type a command that is not part of your system, the sys- 
tem prints an error message. 
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APL 

The APL command invokes the APL interpreter. 



Because APL has its own command language, the APL command accepts no 
options and no file specifications. For information on using the APL inter- 
preter, see the APL— 11 Programmer's Reference Manual. 
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ASSIGN 



The ASSIGN command associates the logical name you specify with a phys- 
ical device. 



ASSIGN rip) physlcal-devlce-name ( SP) loglcaldevlce-name 



In the command syntax illustrated above, physical-device-name represents 
the RT-11 standard permanent name that refers to a particular device tltiat 
is installed on your system. Table 3-1 contains a list of these names. The 
term logical-device-name represents an alphanumeric name, from one to 
three characters long, that you assign to a particular device. Note that you 
can not use spaces or tabs in the logical device name. If you type ASSICrN, 
followed by a carriage return, the system prompts: Physical device name?. If 
you follow the physical device name with a carriage return, the system 
prompts: Logical device name?. 

If the logical device name you supply is already associated with a physical 
device, the system disassociates the logical name from that physical device 
and assigns it to the current device. You can assign only one logical name 
with each ASSIGN command, but you can use several ASSIGN commands 
to assign different logical names to the same device. You can also use the 
ASSIGN command to assign FORTRAN logical units to physical devices 
(see the RT-lllRSTSIE FORTRAN IV User's Guide). 

The ASSIGN command simplifies programming. When you write a i>ro- 
gram, for example, you can request input from a device called INP: and 
direct output to a device called OUT:. When you are ready to execute the 
program, you can assign those logical names to the physical devices you 
need to use for that job. The ASSIGN command is especially helpful when a 
program refers to a device that is not available on a certain system; the 
ASSIGN command allows you to direct input and ouput to an available 
device. 

Note that BA and SY are always invalid as logical device names. 

The following command, for example, causes data that you write to deAdce 
LST: to print on the line printer. 

.ASSIGN I.,.P: LSI J 

If your program attempts to access a device by using a logical name (such as 
LST:) and you do not issue an appropriate ASSIGN command, an error 
occurs in the program. 

The following command redirects printer output to the terminal. 

.ASSIGN TTJ LPt 

The command shown above illustrates how you can run a program that sipe- 
cifically references LP: without using a line printer. 
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ASSIGN 

The next command redefines the default file device. 

.ASSIGN RK:l. 5 DKS 

If you supply a file specification and omit the device name, it now defaults to 
RKl:. Note that this does not affect the default system device, SY:. 

The last example is typical ibr a system that uses a dual-drive diskette 
device. Several users can share the same system software on DXO: and 
maintain their own data files on diskettes that they run in drive 1. When 
you use the following command, references to files without an explicit device 
name automatically access DXl:. 

.ASsitCvN i:ix:i, ! dk; 

Use the SHOW command to display logical device name assignments on the 
terminal. 
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B 



The B (Base) command sets a relocation base. To obtain the address of the 
location to be referenced in a subsequent Examine or Deposit command, the 
system adds this relocation base to the address you specify. 



B [(SP ) address] 



In the command syntax shown above, address represents an octal address 
that the system uses as a base address for subsequent Examine and Depiosit 
commands. If the address you supply is an odd number, the system decreases 
it by one to make the address even. Note that if you do not specify an 
address, this command sets the base to zero. 

Use the B command when using the Examine and Deposit commands to ref- 
erence linked modules that you have loaded into memory with the GET com- 
mand. (Note that the Base command has no effect on program execution.) 
The system adds the current base address to the value you supply in an 
Examine or Deposit command. You can set the current base address to the 
address where a particular module is loaded. Then you can use the reloca- 
table addresses printed in the assembler, compiler, or map listing of that 
module to reference locations within the module. 

The following command sets the base to 0. 

The next two commands both set the base to 1000. 

.B 1.000 
.B 1.00:1. 
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BASIC 

The BASIC commahd invokes the BASIC language interpreter. 



Because BASIC has its own command language, the BASIC command 
accepts no options and no file specifications. For information on using the 
BASIC interpreter, see the BASIC-11 Language Reference Manual. 
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BOOT 

The BOOT command directs a new monitor to take control of the systero. It 
can also read into memory a new copy of the monitor that is currently con- 
trolling the system. 



BOOT f/FOREIGNl Csp) lllospec 
[/WAIT J 



In the command syntax illustrated above, filespec represents the device or 
monitor file to be bootstrapped. If you omit filespec, the system prompts you 
with Device or file?. The BOOT command can perform either of two oper- 
ations: (1) a hardware bootstrap of a specific device, or (2) a direct bootstrap 
of a particular monitor file that does not use the bootstrap blocks on the 
device. When you bootstrap a volume, make sure that the appropriate device 
handler is present on that volume. 

To perform a hardware bootstrap, specify only a device name in the com- 
mand line. The following devices are valid for this operation: 



DTO: 


-DT7: 


DX0:-DX1: 


RKO 


-RK7: 


PD0:-PD1: 


RF: 




DD0:-DD1: 


SY: 




DL0:-DL3: 


DK: 




DY0:-DY1: 


DPO: 


-DP7: 


DM0:-DM7 


DSO: 


-DS7: 





You can also boot any of the above storage volumes by specifying its logical 
name, if assigned (see the ASSIGN command). The hardware bootstrap 
operation gives control of the system to the monitor whose bootstrap is writ- 
ten on the device. (You can change this monitor by using the COPY/BOOT 
command.) This example bootstraps the single-job monitor, RTllSJ, whose 
bootstrap information is written on device DK:. 

.BOOT DK! 
RT-:l,:I.SJ MO 4. 00 

To bootstrap a particular monitor file, specify that file name and the dtsvice 
on which it is stored, if necessary, in the command line. SY: is the deJ'ault 
device, and .SYS is the default file type. 

You can use the BOOT command to alternate between the single-job and 
foreground/background monitors. When you use the BOOT command to 
change monitors you do not have to reenter the date and time. The system 
clock, however, may lose a few seconds during a reboot. The next example 
bootstraps the foreground/background monitor on device SY:, which is cur- 
rently RKO:. 

.BOOT RTl. :l.l-'B 
RT-l:lFB WA,OQ 
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BOOT 
NOTE 

If you are running a foreground or system job that is sending 
I/O to the system volume, using the BOOT command may 
cause your system to hang. You should terminate such a job in 
the foreground before using the BOOT command. 

/FOREIGN Use this option to boot a pre-version 4 volume or a non-RT-11 
system. You may not specify a file name with /FOREIGN. The /FOREIGN 
option does not preserve the date or time. 

/WAIT The /WAIT option is useful if you have a single-disk system. When 
you use this option, the system initiates the BOOT procedure but then pauses 
and waits for you to mount the volume you want to bootstrap. When the 
system pauses, it prints Mount input volume in <device>; Continue? at the 
terminal, where <device> represents the device into which you mount the 
volume. Mount the volume you want to bootstrap, then type Y followed by a 
carriage return. 

The following sample command line boots an RK05 disk: 

.BOOT/WAIT RKOJ 

Mount Input voluirie :i.n RKOS:! Continue? Y 
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CLOSE 



The CLOSE command closes and makes permanent all output files that are 
currently open in the background job. 



The CLOSE command accepts no options or arguments. 

You can use the CLOSE command to make tentative open files permanent; 
otherwise, they do not appear in a normal directory listing and the space 
associated with the files is available for reuse. The CLOSE command is ]Dar- 
ticularly useful after you type a CTRL/C to abort a background job. You can 
also use it after an unexpected program termination to preserve any new 
files that were being used by the terminated program. Note that the CLOSE 
command has no effect on a foreground job and that you cannot use CLOSE 
on files opened on magnetic tape or cassette. 

The CLOSE command does not work if your program defines new inpxjit or 
output channels (with the .CDFN programmed request). Because CTRL/C or 
.EXIT resets channel definitions, the CLOSE command has no effect on 
channels it does not recognize. 

The following example shows how the CLOSE command makes temporary 
files permanent. 

.R PROG 



■'C "C 
. CLOSEi: 
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COMPILE 



The COMPILE command invokes the appropriate language processor to 
assemble or compile the files you specify. 



COMPILE 



/LIST |:fllespec] [/ALL0CATE:slZ3| 

/(NOl OBJECT |:fllespec] [/ALLOC ATE:slze) 

"/DIBOL 

'/ALPHABETIZE 
/CROSS REFERENCE 
/[NO] LINENUMBERS 
/ON DEBUG 
/(NO] W ARNING S 
/FORTRAN 
/CODE:type 
/DIAGNOSE 
/EXTEND 
/HEADER 
/I4 

/|N01 LINENUMBERS 
/ONDEBUG 
/[NO] OPTIMIZE |:lypel 
/RECORD:length 
/SHOW (:value] 
/STATISTICS 
/[NO] SWAP 
/UNITS:n 
/[NO] VECTORS 
/WARNINGS 



/CROSSREFERENCE ;:lype[ 
/DISABLE:value [. . .:valuel 
/ENABLE:value [. . rvalue) 
/|N0] SHOW:value 



:type|l 



( SP) fllespoc r 



/LIBRARY 1 
/PASSrI J 



In the command line shown above, filespecs represents one or more files to be 
included in the assembly or compilation. The default file types for the output 
files are .LST for listing files and .OBJ for object files. The defaults for input 
files depend on the particular language processor involved and include 
.MAC for MACRO files, .FOR for FORTRAN files, and .DBL for DIBOL files. 

To compile (or assemble) multiple source files into a single object file, sepa- 
rate the files by plus ( + ) signs in the command line. Unless you specify oth- 
erwise, the system creates an object file with the same name as the first 
input file and gives it an .OBJ file type. To compile multiple files in inde- 
pendent compilations, separate the files by commas (,) in the command line. 
This generates a corresponding object file for each set of input files. You can 
combine up to six files for a compilation producing a single object file. 

Language options are position-dependent — that is, they have different 
meanings depending on where you place them in the command line. Options 
that qualify a command name apply across the entire command string. 
Options that follow a file specification apply only to the file (or group of files 
separated by plus signs) that they follow in the command string. 

You can specify the entire COMPILE command as one line, or you can rely 
on the system to prompt you for information. The COMPILE command 
prompt is i^tZes?. 
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COMPILE 

There are three ways to establish which language processor the COMP][LE 
command invokes. 

1. Specify a language-name option, such as /MACRO, which invokes the 
MACRO assembler. 

2. Omit the language-name option and explicitly specify the file type for 
the source files. The COMPILE command then invokes the language 
processor that corresponds to that file type. Specifying the file 
SOURCE.MAC, for example, invokes the MACRO assembler. 

3. Let the system choose a file type of .MAC, .DBL, or .FOR for the sovirce 
file you name. To do this, the handler for the device you specify must be 
loaded. If you specify DX1:A and the DX handler is loaded, the system 
searches for source files A.MAC and A.DBL, in that order. If it finds one 
of these files, the system invokes the corresponding language processor. 
If it cannot find one of these files, or if the device handler associated v/ith 
the input file is not resident, the system assumes a file type of .FOR and 
invokes the FORTRAN compiler. 

If the language processor selected as a result of one of the procedures 
described above is not on the system device (SY:), the system issues an eifror 
message. 

The following sections explain the options you can use with the COMPILE 
command. 

/ALLOCATE:size Use this option with /LIST or /OBJECT to reserve 
space on the device for the output file. The argument size represents the 
number of blocks of space to allocate. The meaningful range for this value is 
from 1 to 32767. A value of -1 is a special case that creates the largest file 
possible on the device. 

/ALPHABETIZE Use this option with /DIBOL to alphabetize the entries 
in the symbol table listing. This is useful for program maintenance and 
debugging. 

/CODErtype Use this option with /FORTRAN to produce object code that 
is designed for a particular hardware configuration. The argument iype rep- 
resents a three-letter abbreviation for the type of code to produce. The l<jgal 
values are: EAE, EIS, FIS, and THR. See the RT-11/RSTS/E FORTRAN IV 
User's Guide for a complete description of the types of code and their 
function. 

/CROSSREFERENCE[:type[...:type]] Use this option with /MACRO or 
/DIBOL to generate a symbol cross-reference section in the listing. This 
information is useful for program maintenance and debugging. Note that 
the system does not generate a listing by default. You must also specify 
/LIST in the command line to get a cross-reference listing. 

With /MACRO, this option takes an optional argument. The argument type 
represents a one-character code that indicates which sections of the cross- 
reference listing the assembler should include. See the MACRO commarid in 
this chapter for a summary of valid arguments and their meaning. 
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/DIAGNOSE Use this option with /FORTRAN to help analyze an internal 
compiler error. /DIAGNOSE expands the crash dump information to include 
internal compiler tables and buffers. Submit the diagnostic printout to 
DIGITAL with an SPR form. The information in the listing can help the 
DIGITAL programmers locate the compiler error and correct it. 

/DIBOL This option invokes the DIBOL language processor to compile the 
associated files. 

/DISABLE:value[...:value] Use this option with /MACRO to specify a 
.DSABL directive. See the MACRO command in this chapter for a summary 
of the arguments and their meaning. See the PDP-11 MACRO Language 
Reference Manual for a description of the directive and a list of all legal 
values. 

/ENABLE:value[...:value] Use this option with /MACRO to specify an 
.ENABL directive. See the MACRO command in this chapter for a summary 
of the arguments and their meaning. See the PDP-11 MACRO Language 
Reference Manual for a description of the directive and a list of all legal 
values. 

/EXTEND Use this option with /FORTRAN to change the right margin 
for source input lines from column 72 to column 80. 

/FORTRAN This option invokes the FORTRAN language processor to 
compile the associated files. 

/HEADER Use this option with /FORTRAN to include in the printout a 
list of options that are currently in effect. 

/I4 Use this option with /FORTRAN to allocate two words for the default 
integer data type (FORTRAN uses only one-word integers) so that it takes 
the same physical space as real variables. 

/LIBRARY Use this option with /MACRO to identify a macro library file; 
use it only after a library file specification in the command line. The 
MACRO assembler looks first to any MACRO libraries you specify before 
going to the default system macro library, SYSMAC.SML, to satisfy refer- 
ences (made with the .MCALL directive) from MACRO programs. In the 
example below, the two files A. FOR and B.FOR are compiled together, pro- 
ducing B.OBJ and B.LST. The MACRO assembler assembles C.MAC, satis- 
fying .MCALL references from MYLIB.MAC and SYSMAC.SML. It 
produces C.OBJ and C.LST. 

. coMF' :i: LE A+B/L :i: st/object » myl :i: b/l :i: brar y+c , mac/i... i st/dbject 

/LINENUMBERS Use this option with /DIBOL or /FORTRAN to include 
internal sequence numbers in the executable program. These numbers are 
especially useful in debugging programs. This is the default operation. 

/NOLINENUMBERS Use this option with /DIBOL or /FORTRAN to sup- 
press the generation of internal sequence numbers in the executable pro- 
gram. This produces a smaller program and optimizes execution speed. Use 
this option to compile only those programs that are already debugged; other- 
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wise the line numbers in DIBOL or FORTRAN error messages are diffic:ult 
to interpret. 

/LIST[:filespec] You must specify this option to produce a compilation or 
assembly listing. The /LIST option has different meanings depending on its 
position in the command line. 

If you specify /LIST without a file specification in the list of options that 
immediately follows the command name, the system generates a listing that 
prints on the line printer. If you follow /LIST with a device name, the system 
creates a listing file on that device. If the device is a file-structured device, 
the system stores the listing file on that device, assigning it the first input 
file name and a .LST file type. The following command produces a listing on 
the terminal: 

. C0MF'1I...E/L :i: ST J TT ; A . FOR 

The next command creates a listing file called A. LST on RK3:. 

. c;oMP I I..E/I... I s r { RK3 ; a . m ac 

If the /LIST option contains a name and file type to override the default of 
.LST, the system generates a listing file with that name. The following com- 
mand, for example, compiles A. FOR and B.FOR together, producing files 
A.OBJ and FILEl.OUT on device DK:. 

. c M p :i I... e:/ F'- R T R A N / 1., :i: ii) T ! F :r i... ii • :i. , o u t a f b 

Another way to specify /LIST is to type it after the file specification to whiich 
it applies. To produce a listing file with the same name as a particular input 
file, you can use a command similar to this one: 

. c a M f •■ :i: i... e / n :i: b o i... a i- b / 1... :i: sit \^ k 3 i 

The command shown above compiles A.DBL and B.DBL together, producing 
files DK:A.OBJ and RK3:B.LST. If you specify a file name on a /LIST option 
following a file specification in the command line, it has the same meaning 
as when it follows the command. The following two commands have the 
same results: 

.(:;oMP:tLE/MACRO a/lj:stjb 
. c M p :i; 1... E / M A c; i-i / 1... :i: <!) r ; B A 

Both the commands shown above generate as output files A.OBJ and B.LST 
on device DK:. 

Remember that file options apply only to the file (or group of files that are 
separated by plus signs) they follow in the command string. For examples: 

. c M p :t I... i;:: a . h a c / 1... isr,ii \ f o r 

This command compiles A.MAC, producing A.OBJ and A.LST on DK:. It 
also compiles B.FOR, producing B.OBJ on DK:. However, it does not pro- 
duce any listing file for the compilation of B.FOR. 
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/MACRO This option invokes the MACRO assembler to assemble the 
associated files. 

/OB JECT[:filespec] Use this option to specify a file name or device for the 
object file. Because the COMPILE command creates object files by default, 
the following two commands have the same meaning: 

.COMPn.E/FORTRAN A 

. c M !=■ :i: I... E / F R T r; A N / B J lii: C T A 

Both commands compile A. FOR and produce A. OBJ as output. The 
/OBJECT option functions like the /LIST option; it can be either a command 
or a file qualifier. 

As a command option, /OBJECT applies across the entire command string. 
The following command, for example, assembles A.MAC and B.MAC sepa- 
rately, creating object files A OBJ and B.OBJ on RKl:. 

. COMPILE/OBJECT i RK:I. t ( A v B) . MAC 

Use /OBJECT as a file option to create an object file with a specific name or 
destination. The following command compiles A.DBL and B.DBL together, 
creating files B.LST and B.OBJ. 

. C CI M P 1 1... E / D I » 1... A + B / L 1 S T / B J E C T 

/NOOBJECT Use this option to suppress creation of an object file. As a 
command option, /NOOBJECT suppresses all object files; as a file option, it 
suppresses only the object file produced by the related input files. In this 
command, for example, the system compiles A.FOR and B.FOR together, 
producing files A. OBJ and B.LST. It also compiles C.DBL and produces 
C.LST, but it does not produce C.OBJ. 

.COMPILE A.POR+BJ~OR/I...TSTfC;.nBL/N(:)(:)BJECT/L:i:sr 

/ONDEBUG Use this option with /DIBOL to include a symbol table in the 
object file. You can then use a debugging program to find and correct errors 
in the object file. 

Use /ONDEBUG with FORTRAN to include debug lines (those that have a 
D in column 1) in the compilaition. You do not, therefore, have to edit the file 
to include these lines in the coihpilation or to logically remove them. This 
option means that you can include messages, flags, and conditional branches 
to help you trace program ex(Jcution and find errors. 

/0]PTIMIZE[:type] Use this option with /FORTRAN to enable certain 
options that optimize object code for various conditions. The argument type 
represents the three-letter code for the type of optimization to enable. Table 
4-4 summarizes the codes and their meaning. This option is not available in 
version 2.5 of the FORTRAN compiler. 

/NOOPTIMIZE[:type] Use: this option with /FORTRAN to disable certain 
options that optimize object code for various conditions. The argument type 
represents the three-letter code for the type of optimization to disable. Table 
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4-4 summarizes the codes and their meaning. This option is not available in 
version 2.5 of the FORTRAN compiler. 

/PASS:1 Use this option with /MACRO on a prefix macro file to process 
that file during pass 1 of the assembly only. Using this option means that 
you can assemble a source program together with a prefix file that contains 
only macro definitions, because these definitions do not need to be redefined 
in pass 2 of the assembly. The following command assembles a prefix file and 
a source file together, producing files PROGl.OBJ and PROGl.LST. 

. COMPILE/MACRO PRE- F IX/PASB : :l •JPROGil./LTST/DPJECT 

/RECORD:length Use this option with /FORTRAN to override the 
default record length of 132 characters for ASCII sequential formatted input 
and output. The meaningful range for the argument length is from 4. to 4(D95. 

/SHOW:value Use this option with /FORTRAN to control FORTRAN list- 
ing format. The argument value represents a code that indicates which list- 
ings the compiler is to produce. Table 4-5 summarizes the codes and their 
meaning. 

Use this option with /MACRO to specify any MACRO .LIST directive. Table 
4-12 summarizes the valid arguments and their meaning. The PDF— 11 
MACRO Language Reference Manual explains how to use these directives. 

/NOSHOW:value Use this option with MACRO to specify any MAC3R0 
.NLIST directive. Table 4-12 summarizes the valid arguments and tllieir 
meaning. The PDP-11 MACRO Language Reference Manual explains ]bow 
to use these directives. 

/STATISTICS Use this option with /FORTRAN to include compilation 
statistics in the listing, such as amount of memory used, amount of time 
elapsed, and length of the symbol table. 

/SWAP Use this option with /FORTRAN to permit the USR (User Service 
Routine) to swap over the FORTRAN program in memory. This is the 
default operation. 

/NOSWAP Use this option with /FORTRAN to keep the USR resident 
during execution of a FORTRAN program. This may be necessary if the 
FORTRAN program uses some of the RT-11 system subroutine calls (see 
the RT—11 Programmer's Reference Manual). If the program frequently 
updates or creates a large number of different files, making the USR resi- 
dent can improve program execution. However, the cost for making the USR 
resident is 2K words of memory. 

/UNITS:n Use this option with FORTRAN to override the default number 
of logical units (6) to be open at one time. The maximum value you can spec- 
ify for n is 16. 

/VECTORS This option directs FORTRAN to use tables to access multi- 
dimensional arrays. This is the default mode of operation. 
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/NOVECTORS This option directs FORTRAN to use multiplication oper- 
ations to access multidimensional arrays. 

/WARNINGS Use this option to include warning messages in DIBOL or 
FORTRAN compiler diagnostic error messages. These messages call certain 
conditions to your attention but do not interfere with the compilation. This 
is the default operation for DIBOL. 

/NOWARNINGS Use this option with /DIBOL or /FORTRAN to suppress 
warning messages during compilation. These messages are for your infor- 
mation only; they do not affec;t the compilation. This is the default operation 
for FORTRAN. 
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The COPY command performs a variety of file transfer and maintenEince 
operations. 



COPY 


"" /BOOT [:vall 

/DEVICE [/VERIFY] 
/FILES 


( SP ) inputfilespecs 


/DOS (/OWNER:[nnn,nnn||" 

/INTERCHANGE 

/POSITION:n 

/TOPS 

/ENDm 


( SP ^output-lilespoc 


f/ALLOCATElsIze V 
/DOS 

/INTERCHANGE|:siZ9l 
/POSITION:!! 
./STARTin 






r /ASCII 1 




/STARTin 








/BINARY 


""* 






I /IMAGE 








/CONCATENATE 








/EXCLUDE 








/IGNORE 








/[N0| LOG 








/NEWFILES 








/PACKED 








/PREDELETE 








/[NOl QUERY 








/[NO] REPLACE 








/SETDATE 








/SLOWLY 








/SYSTEM 








/WAIT 















The COPY command transfers: 

• one file to another file 

• a number of files to a single file by concatenation 

• the contents of a device to another device 

• the contents of a bootstrap to a device 

• the contents of a device to a file and vice versa 

In the command syntax shown above, input-filespecs represents the data to 
copy. The input-filespec can be a device name, if you use the /DEVICE 
option. Otherwise, you can specify as many as six files for input. Output- 
filespec represents the device or file to receive the data. You can specify only 
one output device or file. 

Normally, commas separate the input files if you specify more than one. 
However, you can separate them by plus ( + ) signs if you want to comlbine 
them, as the following example shows: 

.COPY A.FORfB.FOR C.F-OR 

This command combines DK:A.FOR with DK:B.FOR and stores the results 
in DK:C.FOR. 

Note that because of the file protection feature, you cannot execute any 
COPY operations that result in the deletion of a protected file. For example, 
you cannot copy a file from one volume to another if a protected file of the 
same name already exists on the output volume. 
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Yoxi can use wildcards in the; input or output file specification of the com- 
mand. However, the output file specification cannot contain embedded wild- 
cards. Note that for all operations except CONCATENATE, if you use a 
wildcard in the input file specification, the corresponding output file name or 
file type must be an asterisk (*). This example uses wildcards correctly: 

.COPY AXB.MAC *.BAK 

In the CONCATENATE operation, the output specification must represent 
a single file. Therefore, no wildcards are allowed. 

You can enter the COPY command as one line, or you can rely on the system 
to prompt you for information. If you type COPY followed by a carriage 
return, the system prompts From?. If you type the input specification fol- 
lowed by a carriage return, the system prompts To'?. 

The system has a special way of handling system (.SYS) files and files that 
cover bad blocks (.BAD files). The system requires you to use the /SYSTEM 
option when you need to copy system files. You cannot copy system files sim- 
ply by placing wildcards in file specifications. To copy a .BAD file, you must 
specify it by explicitly giving its file name and file type. Since .BAD files 
cover bad blocks on a device, you usually do not need to copy, delete, or oth- 
erwise manipulate these files. You can copy protected files (see RENAME), 
but you cannot copy the protection status of a protected file (except with the 
COPY/DEVICE command). 

NOTE 

If you transfer files to a storage volume that has never been 
initialized with RT-11, a system failure may result. 

The following sections describe the COPY command options and include 
command examples. 

/ALLOCATE:size Use this option after the output file specification to 
reserve space on the device fo]" the output file. The argument size represents 
the number of blocks of space to allocate. The meaningful range for this 
value is from 1 to 32767. A value of-1 is a special case that creates the larg- 
est file possible on the device. 

/ASCII This option copies files in ASCII mode, ignoring and eliminating 
nulls and rubout characters. It converts data to the ASCII 7-bit format and 
treats CTRL/Z (32 octal) as the logical end-of-file on input. Files that consist 
of ASCII-format data include; source files you create with the editor, map 
files, and list files. The following example copies a FORTRAN source pro- 
gram from DXO: to DXl:, giving it a new name, and reserving 50 blocks of 
space for it. 

. COPY/Asc :i: :i: nxo ; m atr :i: x > for dx :i. % test . for/allocate ; so 

/BINARY Use this option to copy formatted binary files, such as .OBJ files 
produced by the assembler or the FORTRAN compiler, and .LDA files pro- 
duced by the linker. The system verifies checksums and prints a warning if a 






Keyboard Commands 4—33 



COPY 

checksum error occurs. If this happens, the copy operation does not com- 
plete. The following command copies a binary file from DK: to a diskette. 

.copy/b:i:nary analyz.obj i;ix:i. !*.* 

Note that you cannot copy library files with the /BINARY option because a 
checksum error occurs. Copy them in image mode, or when you are creating 
a bootable RXOl system while the current system is on an RX02. 

/BOOT[:val] This option copies bootstrap information from a monitor and 
handler files to blocks and 2 through 5 of a random-access volume, permit- 
ting you to use that volume as a system volume. The optional argument val 
represents a two-letter target system device name that you use when you 
are creating a bootable PDT system volume on a PDP-11, and vice versa. 
You can also use this notation to create a bootable RXOl system while the 
current system is on an RX02 diskette. Note that you cannot combine 
/BOOT with any other option, and that your input and output volume must 
be the same. Also note that you can name your monitor file any name you 
wish. When you perform this operation, you must have the correct device 
handler to go with the volume. For example, to create a bootable RK05 disk, 
you must have the handler file RK.SYS on that RK05. 

To create a bootable system volume, follow the procedure below: 

1. Initialize the volume, using the keyboard monitor command 
INITIALIZE. (Note that if the volume is an RK06/07 or an RLOl/02, you 
should also use the /REPLACE option.) 

2. Copy files onto the volume, using the COPY/SYSTEM command. 

3. Write the monitor bootstrap onto the volume, using COPY/BOOT. 
The following example creates a system diskette. 

.in:i:t;i:ai...:i:ze dxi. 2 

DX1. :/:i:n:i.t:i.e:i. :i.zei! Are «ou sure 'I' Y 

. COH' Y/S YSTEH DXO tt,t DX J. S * . * 
Files copied S 

D X : R T :i. :i. s , J . s Y !;; to d x :i. ; r^ ■ r ■ i ;i. s j . s; r s 

DXOSDT.SYS to DX:I. ;DT . SYS 

DXOJDX.SYS to i:iX:l. SDX.SYS 

DX0;TT.SYS to DX:l. JTT.SYS 

P X J I... P , S Y S to i;i X 1, ; U-' . 3 Y s 

D X ! D 1 R , S A y to 10 X :l, ; iCi I T^ . 3 A U 

D X : n u p , s A u t cj » x :i. u:u..i i-' , s a y 

D X ! A B C; . M A C to .0 X :l. ; A B C . M A C; 
D X : A A I" , h A C 1,0 ICi X :l. S A A r- . M A C 
nXOJCT.SYS to DX:l. SCT.SYS 

n X ; T' i I"' , s A V to d x :i. ; i-' :i: p . s a m 
D X ; M T . s Y s to n x 1 ! M r . ;;; Y s 

DXOtMH.SYS to DX:l. SMiUSYS 

i:i X ; c M B . i:i A r to i) x :i. ; c o m b . d a r 
n X ; R T :u, r- B . s Y 3 to o x :l : i-^ t 1 1 r- b . s y s 

. COPY/BOOT DX1. ; RT J. 1.FB . SYS DX:I. ! 
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The device names you can use for the optional argument val are PD, DD, DX, 
and DY. The following example creates a bootable system diskette for a PDT 
while the current system is on a PDP-11: 



. COPY/BOOT jpn i:ixo:rti;lsj,sys dxo; 

The following example creates a bootable system diskette for a PDP-11 while 
the current system is on a PDT-11/150: 

. c p Y / B T : i:i X r> ru. ; r r i :i. s j , is y s p n \. t 

Note that the monitor file cannot reside on a block that contains a bad sector 
error (BSE) if you are doing bad block replacement. If this condition occurs, a 
boot error results when you bootstrap the system. In this case, move the 
monitor so that it does not reside on a block with a BSE error. 

/CONCATENATE Use this option to combine several input files into a 
single output file. This option is particularly useful to combine several object 
modules into a single file for use by the linker or librarian. The following 
command combines all the .FOR files on DXl: into a file called MERGE. FOR 
on DXO: 

. COPY/CONCATENATE nxi ! * , FOR DXO i MERGE . FOR 
F:i. l&s copied t 

ri X II A . I- R to D X ! M i;:: R G e: , I" R 

n X K B J"- R to n X 1 M i;- R G f ;: <. i-- or;; 

X :i. ; c; . i- o r t o n x o ; m i-;: r fi f ;: ,. r • o r 

Wildcards are illegal in the output file specification. 

/DEVICE This option copies block for block the image of one device to 
another, and copies all data from one disk to another without changing the file 
structure or the location of the files on the device. This is convenient because 
the bootstrap blocks also remain unchanged. You can copy disks that are not 
in RT-11 format if they have no bad blocks. When copying RT-11 disks, you 
can ensure the integrity of the results by making sure the disk being copied 
contains no bad blocks. If the system encounters a bad block during the 
COPY/DEVICE operation it prints an error message. When copying any disk 
using COPY/DEVICE, make sure the output device contains no bad blocks 
because this operation will write over bad blocks on the output device. 

If one device is smaller than the other, the system copies only as many blocks 
as the smaller device contains. For example, if you copy a large volume to a 
smaller one, you copy the entire directory of the input volume, but not every 
file in the input volume. It is possible to copy blocks between disk and mag- 
tape, even though magtape is not a random-access device. The data is stored 
on tape formatted in IK-word blocks. Because magtape is not file-structured, 
there is room for only one disk image on a magtape. The following command 
copies an image of DXO: to DXl:. 

.COPY/DEVICE nxo; nxi. : 

DX.I. J/Copa P Are you sure? Y 

Respond to the query message by typing Y and a carriage return. Any re- 
sponse not beginning with Y cancels the command and the COPY operation 
does not proceed. 
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NOTE 

The COPY command does not copy track of diskettes. 
However, this restriction has no impact on any copy oper- 
ations if your diskette was supplied by DIGITAL. 

/DOS Use this option to transfer files between RSTS/E or DOS-11 format 
and RT-11 format. The option must appear in the command line after the 
file to which it applies. Valid input devices are DECtape and RK05; the only 
valid output device is DECtape. The only other options allowed with /DOS 
are /ASCII, /BINARY, /IMAGE, and /OWNER: [nnn,nnn]. The follovdng 
command transfers a BASIC source file from a DOS-11 disk to an RT-11 
disk. 

, COPY RK : PROG , BAS/nOS/OUINH- R ! i: 200 v 200 1 SYS*, t 

The next command copies a memory image file from an RT-11 disk to a 
RSTS/E format DECtape. 

.COPY DUMP.sAU dt;*.*/dos 

/END:n Use with /START: n and /DEVICE to specify the last block of the 
volume you are copying. The /END:n notation must follow the input file 
specification. The argument n represents a decimal block number. The fol- 
lowing example copies blocks to 500 from RKO: to RKl:, starting at block 
501, in a file named ADAM.MAC: 

, COPY RKO ; /START i O/END i 500 RK :l. t ADAM . MAC/START t 50 :L 

/EXCLUDE This option copies all the files on a device except the ones you 
specify. The following command copies all files from DXO: to DXl: except 
.OBJ and .SAV files. 

, COPY/EXCLUDE DXO : ( * . OBJ ■/ * . SAV ) DX :l. S * , * 

/FILES Use with /DEVICE to copy a volume to a file on another volume or 
vice versa. If you use a magtape or cassette for the input volume, you naust 
specify a file name with the input volume. This operation is useful if you 
wish to make several copies of a volume that is on a slow device. You can 
copy the volume as a file onto a volume that is on a faster device, and then 
proceed to make copies. Note that when you copy a file to a volume, the 
bootstrap and directory of the output volume are replaced by the equivalent 
blocks of the input file. 

The following example copies diskette DXO: to DLl: as file FLOPPY.BAK: 

. COPY/DEM :i:ce/f:i:i..es dxo : dl:i. j floppy . bak 

The following example copies file DECTAP.BAK to DDO: 

. c p Y / d e: V :i: c e / f :i: i... e s d e: c r a p .bak d d o s 

/IGNORE Use this option to ignore errors during a copy operation. 
/IGNORE forces a single-block data transfer, which you can invoke at any 
other time with the /SLOWLY option. Use /IGNORE if an input error 
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occurred when you tried to perform a normal copy operation. This procedure 
can sometimes recover a file tliat is otherwise unreadable. If there is still an 
error, an error message prints on the terminal, but the copy operation con- 
tinues. This option is invalid with /DOS, /TOPS, and /INTERCHANGE. 

/IMAGE If you enter a command line without an option, Or if you use 
the /IMAGE option, the copy operation proceeds in image mode. Use this 
method to transfer memory image files and any files other than ASCII or for- 
matted binary. Note that you cannot transfer memory image files reliably to 
or from paper tape, or to the line printer or console terminal. You can image- 
copy ASCII and binary data with the following restrictions: 

1. For ASCII data, there is no check for nulls. 

2. For binary data, there is no checksum consideration. 

This command copies a text file to a DECtape for storage: 

. c; c) F' Y I... E r T n: R . T X r d r o : * . * 

The primary advantage to using /IMAGE is that it is faster than /ASCII and 
/BINARY. 

/INTERCHANGE [: size] This option transfers data in interchange format 
between RT-11 block-replaceable devices and interchange diskettes that are 
compatible with IBM 3741 format. The option must appear in the command 
line after the file to which it applies. If the output file is to be in interchange 
format, you can specify the length of each record. The argument size repre- 
sents the record length in characters (the default record length is 80 bytes). 
The following command transfers the RT-11 file WAIT.MAC from device 
DK: to device DXl: in interchange format, giving it the name WAIT. MA. The 
record length is set to 128 (decimal) bytes. 

. COPY WA J;T . MAC DXt I * . */:i:NTErv:CHANGi:i: J :l.28 . 

/LOG This option lists on the j terminal the names of the files that were cop- 
ied by the current command. Normally, the system prints a log only if there 
is a wildcard in the file specification. If you specify /QUERY, the system 
prints the name of each file and asks you for confirmation before the oper- 
ation proceeds. In this case, the query messages replace the log, unless you 
specifically type /LOG/QUERY in the command line. The following example 
shows a copy command line and the resulting log. 

. c 1=' Y / L G D X 1 ! F :i: I... fi: .MAC D X :: F" :t 1... i;;: . M A c 

F'iles copiied; 

DXl : FILE . MAC to uxo J f:i:i.j;: . mac 

/NO LOG This option prevents a list of the files copied from appearing on 
the terminal. 

/NEWFILES Use this option in the command line if you want to copy only 
those files that have the current date. The following example shows a con- 
venient way to back up all nev/ files after a session at the computer. 
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.COPY/NEWF:tl...ES *.* tixi:*.* 

F:i. .les copied J 
DKJA.FaR to DXlSA.r-OR 

riKJB.FOR to rix:i:B.FOR 

DK5C.F0R to DX:i:c;.FOR 

/OWNER:[nnn,nnn] Use this option with /DOS to represent a DOS-11 
user identification code (UIC) for a DOS-11 input device. Note that the 
square brackets are part of the UIC; you must type them. The initial default 
for the UIC is [1,1]. 

/PACKED This option copies files in DECsystem-10, DOS, or interchange 
mode. You can use /PACKED on an input file specification with the /TOPS, 
/DOS, or /INTERCHANGE option to transfer files to RT-11 format. This 
option transfers DECsystem-10 files created by MACYll, MACXll, or 
LNKXll with the /P option. 

/POSITION:!! Use this option when you copy files to or from magtape or 
cassette. The /POSITION:n option lets you direct the tape operation; you can 
move the tape and perform an operation at the point you specify. For all 
operations, omitting the argument n has the same effect as setting n eq[ual 
to {n is interpreted as a decimal number). Since this option applies to the 
device and not to the files, you can specify one /POSITION:n option for the 
output file and one for the input files. 

For magtape read (copy from tape) operations, the /POSITIONrn option 
initiates these procedures: 

1. IfAiisO: 

The tape rewinds and the handler searches for the file you specify. If you 
specify more than one file, the tape rewinds before each search. If the 
file specification contains a wildcard, the tape rewinds only once and 
then the handler copies all the appropriate files. 

2. If ?i is a positive integer; 

The handler looks for the file at file sequence number n. If the file it 
finds there is the one you specify, the handler copies it. Otherwise, the it 
prints an error message. If you use a wildcard in the file specification, 
the handler goes to file sequence number n and then begins to look; for 
the appropriate files. 

3. Ifnis-1: 

The handler starts its search at the current position. Note that if the 
current position is not the beginning of the tape, it is possible that the 
file you specify will not be found, even though it does exist on the tape. 

For magtape write (copy to tape) operations, the /POSITION:n option has 
this effect: 

1. If re is 0: 

The tape rewinds before the handler copies each file. A warning mes- 
sage prints on the terminal if the handler finds another file on the 1;ape 
with the same name and file type, and the handler does not copy the file. 

2. If 7x is a positive integer: 

The handler goes to file sequence number n or to the logical end of tape, 
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whichever comes first. Then it enters the file you specify. If you specify 
more than one file, or if you use a wildcard in the file specification, the 
tape does not rewind before the handler writes each file, and the handler 
does not check for duplicate file names. If the handler finds the sequence 
number n, it creates a nev/ logical end of tape. If there are any files with 
a sequence number greatfjr than n, they are lost. 

3. If 72 is -1: 

The handler goes to the logical end-of-tape and enters the file you spec- 
ify. It does not rewind, and it does not check for duplicate file names. 

4. If n is -2: 

The tape rewinds between each copy operation. The handler enters the 
file you specify at logical £!nd-of-tape or at the first occurrence of a dupli- 
cate file name (but if the handler enters the file over the duplicate file, 
you lose everything after that file). 

The handler also has special procedures for handling cassettes. For cassette 
read (copy from tape) operations, the /POSITION:n option initiates these 
procedures: 

1. IfnisO: 

The cassette rewinds and the handler searches for the file you specify. If 
you specify more than one file, or if you use a wildcard in the file specifi- 
cation, the cassette rewinds before each search, 

2. If « is a positive integer: 

The handler starts from tlie cassette's present position and searches for 
the file you specify. If the handler does not find the file you specify before 
it reaches the nth file from its starting position, it reads the nth file. 
Note that if the starting position is not the beginning of the tape, it is 
possible that the handler will not find the file you specify, even though it 
does exist on the tape. 

3. If n is a negative integer: 

The cassette rewinds, then the handler follows the procedure outlined in 
step 2 above. 

For cassette write (copy to tapeO operations, the /POSITION:n has this effect: 

1. IfnisO: 

The cassette rewinds and the handler writes the file you specify at the 
logical end-of-tape. The handler automatically deletes any file it finds 
that has the same name and file type as the file you specify. 

2. If n is a positive integer: 

The handler starts from the cassette's present position and searches n 
files ahead, deleting along the way any file it finds that has the same 
name and file type as the file you specify. If the handler does not reach 
the logical end-of-tape before it reaches the nth. file from its starting 
position, it enters the file you specify over the nth. file and deletes any 
files beyond it on the tape. If the handler reaches the logical end-of-tape 
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before it reaches the rath file, it writes the file you specify at the encl-of- 
tape position. 

3. If ra is a negative integer: 

The cassette rewinds, then the handler follows the same procedure out- 
lined in step 2 above. 

Chapter 7, Section 7.2.1, contains more detailed information about oper- 
ations involving magtape and cassette. 

/PREDELETE This option deletes a file on the output device that has the 
same name as a file you copy to that device. The system deletes the fil(3 on 
the output device before the copy occurs. Normally, the system deletes a. file 
of the same name after the copy operation successfully completes. This 
option is useful for operations involving devices that have limited space, 
such as diskette. Be careful when you use the /PREDELETE option; ijf for 
any reason the input file is unreadable, the output file will already have 
been deleted and you are left with no usable version of the file. Cassette 
devices are valid for input files but not for output. 

/QUERY If you use this option, the system requests confirmation 
from you before it performs the operation. /QUERY is particularly useful on 
operations that involve wildcards, when you may not be sure which files the 
system selected for an operation. The /QUERY option is valid on the COPY 
command only if both input and output are in RT-11 format. Note that if 
you specify /QUERY in a copy command line that also contains a wildcard in 
the file specification, the confirmation messages that print on the terminal 
replace the log messages that would normally appear. You must respond to 
a query message by typing Y (or anything that begins with a Y) and a car- 
riage return. The system interprets any other response to mean NO, and it 
does not copy the file. The following example copies three of the four l^'OR 
files stored on DK: to DXl:. 



< COPY/QUERY DK 5 * . FOR DX IS*.* 






Fi. les copied J 
DKtA.FOR to DX:l. JA.FOR 
DKSB.FOR to DX:l. SB.FOR 

i:ik;c.for to icixj. jc.for 

DK ; DEMOF 1 . FOR to DX :l. i DEMOI" 1 . 1 


■f 
"OR'!' 


Y 

Y 

N 

■ Y 



/NOQUERY This option suppresses the confirmation message that the 
system prints for some operations, such as COPY/DEVICE. It also sup- 
presses logging of file names if the command line contains a wildcard. You 
must explicitly type /LOG to obtain a list of the files copied. 

/REPLACE This is the default mode of operation for the COPY command. 
If a file exists on the output device with the same name as the file you specify 
for output, the system deletes the duplicate file after the copy operation suc- 
cessfully completes. 

/NOREPLACE This option prevents execution of the copy operation if a 
file with the same name as the output file you specify already exists on the 
output device. /NOREPLACE is valid only if both the input and output; are 
in RT-11 format. 
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/SETDATE This option causes the system to put the current date on all 
files it transfers, unless the current system date is zero. Normally, the system 
preserves the existing file creation date when it copies a file block for block. 
This option is invalid for operations involving magtape and cassette, because 
the system always uses the current date for tape files. 

/SLOWLY This option transfers files one block at a time. On some devices, 
a single-block transfer increases the chances of an error-free transfer. Use this 
option if a previous copy operation failed because of a read or write error. 

/START[:n] Use with the /DEVICE option to specify the starting block and, 
with /END:n, to specify the last block of the disk you are copying. The 
/START:n notation must follow the input or output file specification. The 
argument n with both /START and /END represents a decimal block number. 

You can use /START:n with the output file specification to specify the start- 
ing block number for the write operation on the output volume. 

The following example copies blocks 500 to 550 of RKO: to RKl: starting at 
block 100: 

. COPY RKO % /START 1 500/END X 550 RK I % /START ! :l. 00 

If you do not supply a value with /START, the system assumes the first block 
on the volume. If you do not specify a value with /END, the system assumes 
the last block on the volume. Note that the first block of a file or volume is 
block 0. 

/SYSTEM Use this option if you need to copy system (.SYS) files. If you 
omit this option, the .SYS files are excluded from all operations and a mes- 
sage is printed on the terminal to remind you. 

/TOPS This option transfers files on DECsystem-10 DECtape to RT-11 
format. The option must follow the input file specification. Note that DEC- 
tape is the only valid input device. You cannot perform this copy operation 
while a foreground job is running. Use /PACKED with /TOPS to convert from 
TOPS-10 7-bit ASCII format to standard PDP-11 byte ASCII format. The 
following command copies in ASCII format all the files named MODULE 
from the DECsystem-10 DECtape DTO: to RT-11 device RKO:. 

. c !"■ Y / A s c :i: :i: d t o J m o d u i ... i::: . * / r' o !=• s r;: k o : * . * 

/VERIFY Use this option with /DEVICE to verify that the output matches 
the input after a copy operation. This option cannot be used for file copy 
operations, only for device copy operations. 

/WAIT Use this option on systems that have only a single-disk drive, or on 
systems that have dual drive and the system volume is neither the input nor 
output volume. When you use this option, the system initiates execution of a 
command but then pauses and prints the message Continue?. At this time, 
you can remove the system disk and mount the disk on which you want the 
operation to take place. When the new disk is loaded, type a Y followed by a 
carriage return to resume the operation. When the operation completes, the 
system prints the Continue? message again. Mount the system volume and 
type a Y followed by a carriage return. The system then prints the keyboard 
monitor prompt. Make sure PIP and DUP are on your system volume when 
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you use the /WAIT option. The /WAIT option is valid with /DEVICE. How- 
ever, the /WAIT option cannot be used when you copy to or from non-RT-11 
formatted volumes. Therefore, /WAIT cannot be used with the following op- 
tions: /DOS, ANTERCHANGE, /TOPS. 

Single- Volume Operation 

If you want to transfer a file between two storage volumes, and you have only 

one drive for that type of storage volume, follow the procedure below. 

1. Enter a command string according to this general syntax: 

COPY/WAIT input-filespec output-filespec 

where output-filespec represents the destination device and file specifica- 
tion, and input-filespec represents the source device and file specification. 

2. The system responds by printing the following message at the terminal. 

M o u n t :i. i -i p u t v o :i. 1..1 iti e i n < d e v :i. c e :> P C a n t :i. n u b ? 

<deuice> represents the device into which you are to mount your input 
volume. Type a Y followed by a carriage return after you have mounted 
your input volume. 

3. The system continues the copy procedure and prints the following message 
on the terminal: 

M o 1..1 n t 1..1 1 >■■' u t V o :i. 1..1 m e :i. ri <: d e v :i. (:■ e :> ? (!; o i"i t i n i..i e '? 

4. After you have removed your input volume from the device, mount your 
output volume, then type Y followed by a carriage return. 

5. Depending on the size of the file, the system may repeat the transfer cycle 
(steps 2 and 3) several times before the transfer is complete. When the 
transfer is complete, the system prints the following prompt at the termi- 
nal: 

Mount system volume :i,n <dev:i.cf>>5 Continue? 

When you mount your system volume and type a Y followed by a carriage 
return in response to the last instruction, you terminate the copy opera- 
tion. 

Double-Volume Operation 

If you have a small disk system, you can use the /WAIT option for transferring 
files between two non-system volumes. The procedure for transferring files 
this way follows. 

1. With your system volume mounted, enter a command according to the 
following general syntax: 

COPY/WAIT input-filespec output-filespec 

where output-filespec represents the destination device and file specifica- 
tion, and input-filespec represents the source device and file specification. 

2. After you have entered the last command string, the system responds with 
the following prompt: 

Mount input voiuirie in <dK>vice>5 Continue? 
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Type a Y followed by a carriage return when you have mounted the input 
volume. 

3. The system then prints the next instruction for you to mount the output 
volume: 

Mount output volume :i. n <dev:i. ce>P Cont:i.nu (■:■>? 

Type a Y followed by a carriage return in response to the last message 
after you have mounted the output volume. 

4. Unlike the single-volume transfer, the double-volume transfer involves 
only one cycle of mounting the input and output volumes. When the file 
transfer is complete, PIP prints the following instruction: 

Mount si:(stBm volume :i. n <devj. ce>y Conti nuts? 

When you mount your system volume and type a Y followed by a carriage 
return in response to the last instruction, you terminate the copy opera- 
tion. 
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The CREATE command creates or extends a file with a specific name, loca- 
tion, and size on the block replaceable volume that you specify. 



CREATE ( SP) filBspec 



[/START :n [/ALLOCATE:!!] 
/EXTENSION;n 



In the command syntax illustrated above, filespec represents the device and 
file specifications of the file you wish to create or extend. If you are using the 
CREATE command to create a file, this command only creates a directory 
entry for the file. This command does not store any data in a file. You must 
specify both the file name and type of the file you wish to create or extend. 

If you type a carriage return after typing CREATE, the system prompts 
File?. 

The following sections describe the options you can use with the CREATE 
command. 

/ALLOCATE :n Use this option following the file specification to allocate 
n blocks for the file you are creating, where n represents a decimal number. 
A value of -1 for n indicates a file of the maximum size available on the vol- 
ume. If you do not use /ALLOCATE, the system assumes one block. 

/EXTENSION:!! Use this option to extend an existing file you specify Iby n 
blocks, where re is a decimal number. When you use this option following the 
file specification, make sure that there is enough unused space on the vol- 
ume for the size you specify (use the DIRECTORY/FULL command to do 
this). If you do not supply a value with /EXTENSION, the system assumes 
one block. 

The following example illustrates the procedure for extending a file with the 
CREATE command. In this example, BUILD.MAC is extended by 20 blocks. 
First, a DIRECTORY/FULL command determines whether there is avail- 
able space adjacent to BUILD.MAC. 



.d:i:rectory/fuli... uxoj 
















05 -DEC-?? 


















MYPROG.MAC 3AP 


:l.9' 


NOV- 


■79 


TM .MAC 


25 


27- 


-MM- 


■79 


yTMAC .MAC 7 


19- 


•NOV- 


■79 


SYSMAC.MAC 


•41 


:l.9^ 


•NOV- 


•79 


< UNUSEti > 25 








rt;i.:i,sj.sys 


67 


:l,9- 


•NOM- 


■79 


TT .SYS 2 


:l.9- 


■NOV- 


•79 


nx .SYS 


3 


:l.9^ 


■NOV^ 


■79 


LEI... A .LBM :l. 


05- 


■DEC- 


•79 


BUILD .MAC 


80 


:l.9- 


■MW- 


■79 


< UNUSED > 1.99 



















9 Files »- 2A2 Blockis 
22'4 Free blocks 

Next the CREATE command extends BUILD.MAC by 20 blocks. 

. CREATE nXO ; BUILD . MAC/EXTENSION { 20 
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/START:n Use this option to specify the starting block number of the file 
you are creating. The argument n represents a decimal block number. If you 
do ]aot use /START, the system uses the first available space on the volume. 

The following example illustrates the procedure for creating a file with the 
CREATE command. In this example, SWAP.SYS is restored after having 
been previously deleted. First, a DIRECTORY/DELETED command estab- 
lishes the starting block numbers of the deleted files on DXO: 

, DIRECTORY/DELETED ICiXOI 

05-DEC--79 
SWAP .SYS 25 :l,9-N(:)U-79 ;l. 1. 7 EMPTY. FIL :l.79 3:1, ■■■■OCT ••••79 315 

File's? Blocks 

204 Free blocks 

Next, the CREATE command restores SWAP.SYS, starting at block 117, 
and using the /ALLOCATE:n option to allocate 25 blocks. 

. C R E A T- E D X ! S W A P . S Y S / !;> T A R T S 1 1 7 / A 1... L C A T f- S 2 5 

See the RT-11 Software Support Manual for a detailed description of the 
RT-11 file structure. 
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The D (Deposit) command deposits values in memory, beginning at the loca- 
tion you specify. 



D C^PJ address - vatuo (, . . . value] 



In the command syntax illustrated above, address represents an octal 
address that, when added to the relocation base value from the Base com- 
mand (if you used one), provides the actual address where the system must 
deposit the values. The argument value represents the new contents of the 
address. If you do not specify a value, the system assumes a value of 0. If you 
specify more than one value and separate the values by commas, the system 
deposits the values in sequential locations, beginning at the location you 
specify. 

The Deposit command accepts both word and byte addresses, but it alv^ays 
executes the command as though you specified a word address. (If you spec- 
ify an odd address, the system decreases it by one to make it even.) The 
Deposit command stores all values as word quantities. 

Use commas to separate multiple values in the command line. Two or moi:e 
adjacent commas cause the system to deposit zeroes at the location you spec- 
ify and at the following locations, if indicated. 

Note that you cannot specify an address that references a location outside 
the area of the background job. You can use the D command with GET and 
START to temporarily alter a program's execution. Use the SAVE command 
before START to make the alteration permanent. 

The following command deposits zeroes into locations 300, 302, 304, and 
306. 

. n 300= » y » 

The next command sets the base address to 0. 

The following command deposits 3705 into location 1000. 

Ai :l. 000=3705 

The next command sets the relocation base to 1000. 

.B 1000 

The next command puts 2503 into location 1500 (offset of 500 from the last B 
command) and 22 into location 1502. 

.n 500 =2503 » 22 
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Use the DATE command to set or to inspect the current system date. 



HATE I (^sp) dd-mmmyy] 



In the command syntax shown above, dd represents the day (a decimal num- 
ber from 1 to 31); mmm represents the first three characters of the name of 
the month; and yy represents the year (a decimal number from 73 to 99). 

To enter a date into the system, as soon as you bootstrap the system specify 
the date in the format described above. The system uses this date for newly 
created files, for files that you transfer to magtape or cassette, and for listing 
files. The following example emters the current date. 

.DATE 1.8-MAY-77 

To display the current system date, type the DATE command without an 
argument, as this example shows. 

, riATE 
IS-Msy -77 

The FB and XM monitors automatically increment the date at midnight 
each day. The SJ monitor increments the date only if you select timer sup- 
port as a system generation special feature. Note that you can also select 
automatic end-of-month date advancement through system generation. 
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The DEASSIGN command disassociates a logical device name from a phys- 
ical device name. 



DEASSIGN i QSPJ loglcaldevlcename] 



In the command syntax illustrated above, logical-device-name represents an 
alphanumeric name, from one to three characters long, that is assigned to a 
particular device. Note that spaces and tabs are not permitted in the logical 
device name. 

To remove the assignment of a particular logical device name to a physical 
device, specify that logical device name in the command line. The follov^ing 
example disassociates the logical name INP: from the physical device to 
which it is assigned. 

.riEASsiGN :i:np; 

If you specify a logical name that is not currently assigned, the system 
prints an error message, as this example shows. 

,Di;;: ASSIGN iwx 

'i'KMON-F-l.osii C3:i. ni-jme not found 

To disassociate all logical names from physical devices, type the DEASSIGN 
command without an argument. The following example disassociatesi all 
logical device names (except SY:) from physical devices and resets the log- 
ical names DK: and SY: to represent the system volume. 

.DEASSIGN 

If DK: is assigned to a non-system device (such as DXl:, for example), the 
following command disassociates DK: from DXl: and restores the default 
association of DK: to SY:, the system device. 

.REASSIGN DK: 
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The DELETE command deletes the files you specify. 



DELETE 


/DOS 

/INTERCHANGE 

/EXCLUDE 

/LOG 

/NEWFILES 

/POSmONin 

/(NOl QUERY 

/SYSTEM 

/WAIT 

/ENTRY 


( SP ) filespecs 



In the command syntax shown above, filespecs represents the files to be 
deleted. You can specify up to six files; separate them with commas. You can 
enter the DELETE command as one line, or you can rely on the system to 
prompt you for information. If you omit the file specification, the DELETE 
command prompts Files?. If you delete a file accidentally, it may be possible 
to recover the file if you act immediately (see CREATE). A procedure for 
doing this is described in Chapter 8. 

The system has a special way of handling system (.SYS) files and files that 
cover bad blocks (.BAD files). So that you do not delete system files by acci- 
dent when you use a wildcard in the file specification, the system requires 
yovi to use the /SYSTEM option when you need to delete system files. To 
delete a .BAD file, you must specify it by explicitly giving its file name and 
file type. Since .BAD files cover bad blocks on a device, you do not need to 
copy, delete, or otherwise manipulate these files. To delete a protected file (a 
"P" next to the block size of a file's directory entry denotes protection) use 
the RENAME/NOPROTECTION command. 

Another feature of the DELETE command is that the system unless using 
/LOG or /NOQUERY requests confirmation from you before it deletes a file. 
You must respond to the query message by typing Y followed by a carriage 
return in order to execute the command. 

The following sections describe the options you can use with the DELETE 
command. 

/DOS Use this option to delete a file that is in DOS-11 or RSTS/E format. 
The valid devices for this type of file are disks or DECtapes. You cannot use 
any other option in combination with /DOS. 

/ENTRY Use this option to delete a job from the queue. Use /ENTRY 
when QUEUE is running as a foreground or system job (see Chapter 20, 
Queue Package). 
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When you use /ENTRY, you do not have to specify the input files in the job, 
only the job name. If you have not specified a job name, the system uses the 
first file name in the job as the job name. The following example deLjtes 
MILLER from the queue: 

.riELETEVENTRY MILLER 

If QUEUE is printing a job when you delete that job, QUEUE immediately 
stops processing that job. 

/EXCLUDE This option deletes all the files on a device except the ones 
you specify. The following command, for example, deletes all files from DXO: 
except .SAV files. 

. DELETE/EXCLUDE DXO t « . SAM 
?P1:P-UI-No .>SYS act:i.on 

Files cteleted! 

nXOtABCOLD ? Y 

DXOSAAF.OLn ? Y 

DXO : COMB. ? Y 

DXO ; MERGE. OLD '!> Y 

/INTERCHANGE Use this option to delete from a diskette a file that is in 
interchange format. You cannot use any other option with 
/INTERCHANGE. 

/LOG This option lists on the terminal a log of the files that are deleted by 
the current command. Note that if you specify /LOG, the system does not ask 
you for confirmation before execution proceeds (that is, /LOG implies 
/NOQUERY). Use both /LOG and /QUERY to invoke logging and querying. 

/NEWFILES Use this option to delete only the files that have the current 
system date. This is a convenient way to remove all the files that you just 
created in a session at the computer. The following example deletes the files 
created today. 

.DELETE/NEWEILES DX1. :*.BfiK 

F:iJ,es deleted; 
DX:l. JMERGE.BAK ? Y 

/POSITION[:n] You can use this option when you delete files from cas- 
sette. It permits you to move the tape and perform an operation at the point 
you specify. Omitting the argument n has the same effect as setting re equal 
to (rt is interpreted as a decimal number). The /POSITION:n option has the 
following effect: 

1. IfnisO: 

The cassette rewinds and the system searches for the file you specify. If 
you specify more than one file, or if you use a wildcard in the file specifi- 
cation, the cassette rewinds before each search. 

2. If 71 is a positive integer: 

The system starts from the cassette's present position and searches for 
the file you specify. If the system does not find the file you specify before 
it reaches the nth file from its starting position, it deletes the nth. file. 
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Note that if the starting position is not the beginning of the tape, it is 
possible that the system will not find the file you specify, even though it 
does exist on the tape. 

3. If /I is a negative integer: 

The cassette rewinds, then the system follows the procedure outlined in 
step 2 above. 

/QUERY Use this option to request a confirmation message from the sys- 
tem before it deletes each file. This option is particularly useful on oper- 
ations that involve wildcards, when you may not be completely sure which 
files the system selected for the operation. This is the default mode of oper- 
ation. Note that specifying /LOG eliminates the automatic query; you must 
specify /QUERY with /LOG to retain the query function. You must respond 
to a query message by typing Y (or anything that begins with a Y) and a car- 
riage return to initiate execution of a particular operation. The system 
interprets any other response^ as NO; it does not perform the operation. The 
following example shows querying. Only one file is deleted. 

. Oi;;: LET E /QUERY DX:l. ;*,* 

f":i. :i.es deletecW 
DXl. tABC.HAC ? N 
nXI, JAAF.MAC -I' Y 
DXI! MERGE .FOR ? N 

/NOQUERY This option suppresses the confirmation message the system 
prints before it deletes each file. 

/SYSTEM Use this option if you need to delete system (.SYS) files. If you 
omit this option, the system files are excluded from the DELETE operation, 
and a message is printed on the terminal. (Note that the system prints this 
message only when system files might otherwise be included in the 
operation.) 

/WAIT This option is useful if you have a single-disk system. When you 
use this option, the system initiates the DELETE operation but then pauses 
for you to mount the volume on which you want the operation to take place. 
When the system pauses, it prints Mount input volume in <device>; Con- 
tinue?, where <device> represents the device into which you mount the vol- 
ume. When the volume is mounted, type Y followed by a carriage return. 

The following example deletes FILE. MAC from an RK05 disk: 

. tiELETE/WAIT RKOtF ILE, MAC 

Mount input volume :i. n R'KO!? Continue? Y 

RKOJ FILE. MAC? Y 

Mount system volume :i.n RKOJf Continue? Y 

This option is invalid with /INTERCHANGE and /DOS. 
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The DIBOL command invokes the DIBOL compiler to compile one or more 
source programs. 




/LIST tlllespec] [/ALLOCATE:slze| 

/[NOl OBJECT (:filespecl [/ALLOCATE:slze| 

/ALPHABETIZE 
/CROSSREFERENCE 
/[NOl LINENUWBERS 
fONDEBUG 
/[NO] WARNINGS 



( SP J fllespecs 



In the command syntax illustrated above, filespecs represents one or more 
files to be included in the compilation. If you omit a file type for an input file, 
the system assumes .DBL. Output default file types are .LST for listing files 
and .OBJ for object files. To compile multiple source files into a single object 
file, separate the files by plus ( + ) signs in the command line. Unless you 
specify otherwise, the system creates an object file with the same namij as 
the first input file and gives it an .OBJ file type. To compile multiple files in 
independent compilations, separate the files by commas (,) in the command 
line. This generates a corresponding object file for each set of input files. 

Language options are position-dependent — that is, they have diffei'ent 
meanings depending on where you place them in the command line. Options 
that qualify a command name apply across the entire command striing. 
Options that follow a file specification apply only to the file (or group of files 
separated by plus signs) they follow in the command string. 

You can enter the DIBOL command as one line, or you can rely on the sys- 
tem to prompt you for information. The DIBOL command prompt is Files? 
for the input specification. 

The DIBOL— 11 Language Reference Manual contains more detailed infor- 
mation about using DIBOL. The following sections describe the options you 
can use with the DIBOL command. 

/ALLOCATE :size Use this option with /LIST or /OBJECT to reseirve 
space on the device for the output file. The argument size represents the 
number of blocks of space to allocate. The meaningful range for this value is 
from 1 to 32767. A value of -1 is a special case that creates the largest file 
possible on the device. 

/ALPHABETIZE Use this option to alphabetize entries in the symbol and 
label tables. This is useful for program maintenance and debugging. 

/CROSSREFERENCE This option generates a symbol cross-reference 
section in the listing to which it adds as many as four separate sections to 
the listing. These sections are: (1) symbol cross-reference table, (2) label 
cross-reference table, (3) external subroutine cross-reference table, (4) 
COMMON cross-reference table. Note that the system does not generate a 
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listing by default. You must eiIso specify /LIST in the command line to get a 
cross-reference listing. 

/LINENUMBERS This option generates line numbers for the program 
during compilation. These line numbers are referenced by the symbol table 
segment, label table segment , and the cross-reference listing; they are espe- 
cially useful in debugging DIBOL programs. This is the default operation. 

/NOLINENUMBERS This option suppresses the generation of line num- 
bers during compilation, which produces a smaller program and optimizes 
execution speed. Use this option to compile only programs that are already 
debugged; otherwise the DIB(3L error messages are difficult to interpret. 

/LIST[:filespec] You must specify this option to produce a DIBOL com- 
pilation listing. The /LIST option has different meanings depending on 
where you place it in the comitnand line. 

The /LIST option produces a listing on the line printer when /LIST follows 
the command name. For example, the following command line produces a 
line printer listing after compiling a DIBOL source file: 

. D i: JB 1... / L :i: s T my p i-^ o b < r e t :> 

When the /LIST option follows the file specification, it produces a listing file. 
For example, the following command line produces the listing file 
DK:MYPROG.LST after compiling a DIBOL source file: 

. MBOI... MYPR(:)G/l,..:i:ST<RET> 

If you specify /LIST in the list of options that immediately follows the com- 
mand name, but omit a file specification, the DIBOL compiler generates a 
listing that prints on the line printer. If you follow /LIST with a device 
name, the system creates a listing file on that device. If the device is a file- 
structured device, the system stores the listing file on that device, assigning 
it the same name as the input file with a .LST file type. The following com- 
mand produces a listing on the terminal. 

.D:i:Boi.../i..,,i:sT:TTt a 

The next command creates on RK3: a listing file called A.LST. 

.d:i:bol/i...:i:stsrk3; a 

If the /LIST option contains a name and file type to override the default of 
.LST, the system generates a listing file with that name. The following com- 
mand, for example, compiles A.DBL and B.DBL together, producing on 
device DK: files A.OBJ and FILEl.OUT: 

. 1 B 1.. / lj: s T J I" n.. i::: :i, .our a + b 

Another way to specify /LIST is to type it after the file specification to which 
it applies. To produce a listing file with the same name as a particular input 
file, you can use a command similar to this one: 

.b:i:boi... Af-B/LxsrsRK^; 
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The command shown above compiles A.DBL and B.DBL together, producing 
files DK:A.OBJ and RK3:B.LST. If you specify a file name on a /LIST option 
following a file specification in the command line, it has the same meaning 
as when it follows the command. The following two commands have the 
same results: 

.DIBOL A/t..:i:sT;B 
.i:n:BOi.,/i...:i:sT;B a 

Both commands generate as output files A. OBJ and B.LST. 

Remember that file options apply only to the file (or group of files that are 
separated by plus signs) they follow in the command string. For exampl(j: 

.BTBOl. A/l..:i:ST»B 

This command compiles A.DBL, producing A.OBJ and A.LST. It also com- 
piles B.DBL, producing B.OBJ. However, it does not produce any listing file 
for the compilation of B.DBL. 

/OBJECT[:filespec] Use this option to specify a file name or device for the 
object file. Because DIBOL creates object files by default, the following two 
commands have the same meaning: 

.DIBOL A 
.DIBOL/OBJECT A 

Both commands compile A.DBL and produce A.OBJ as output. The 
/OBJECT option functions like the /LIST option; it can be either a command 
or a file qualifier. 

As a command option, /OBJECT applies across the entire command string. 
The following command, for example, compiles A.DBL and B.DBL S(3pa- 
rately, creating object files A.OBJ and B.OBJ on RKl:. 

.DIBOL/OBJECTtRKt: A y B 

Use /OBJECT as a file option to create an object file with a specific namie or 
destination. The following command compiles A.DBL and B.DBL together, 
creating files B.LST and B.OBJ. 

.DIBOL A+B /LI ST /OBJECT 

/NOOBJECT Use this option to suppress creation of an object file. As a 
command option, /NOOBJECT suppresses all object files; as a file option, it 
suppresses only the object file produced by the related input files. In this 
command, for example, the system compiles A.DBL and B.DBL together, 
producing files A.OBJ and B.LST. It also compiles C.DBL and produces 
C.LST, but does not produce C.OBJ. 

.DIBOL Af B/LIST » C/NOOBJECT/LIST 

/ONDEBUG This option includes a symbol table in the object file. You can 
then use a debugging program to find and correct errors in the object file. 
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/WARNINGS Use this option to include warning messages in DIBOL 
compiler diagnostic error messages. These messages call certain conditions 
to your attention, but they do not interfere with the compilation. This is the 
default operation. 

/NOWARNINGS Use this option to suppress warning messages during 
compilation. 
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The DIFFERENCES command compares two files and lists the differences 
between them. 



DIFFERENCES 


/OUTPUT:(ilespec[/ALLOCATE:slzol 

/PRINTER 

/TERMINAL 


( SP ) oldfile, newflle 






/BINARY 


/ALWAYS 
/BYTES 
/QUIET 
/SIPP:lllespec 


|/START:nl [/ENDin] 








/AUDITTRAIL 

/BLANKLINES 

/CHANGEBAR 

/[NOl COMMENTS 

/FORMFEED 

/MATCH:n 

/SLP 

/[NOl SPACES 

/[NOl TRIM 








1— — 







In the command syntax shown above, oldfile represents the first file t;o be 
compared and new file represents the second. The default output device is the 
console terminal. The default file type for input files is .MAC; for output files 
it is .DIF. You can specify the entire command on one line, or you can rely on 
the system to prompt you for information. The DIFFERENCES command 
prompts are File 1 ? and File 2?. 

The DIFFERENCES command is particularly useful when you want to com- 
pare two similar versions of a source or binary program, typically, an 
updated version against a backup version. A file comparison listing high- 
lights the changes made to a program during an editing session. The follow- 
ing sections describe the various options you can use with the 
DIFFERENCES command. Following the descriptions of the options is a 
sample listing and an explanation of how to interpret it. 

The DIFFERENCES command is also vlseful for creating command files that 
can install patches to backup versions of programs so they match the 
updated versions. The /SLP and /SIPP;filespec options are designed espe- 
cially for this purpose. 

/ALLOCATE:size Use this option with /OUTPUT and /SIPP to reserve 
space on the device for the output listing file. The argument size represents 
the number of blocks of space to allocate. The meaningful range for this 
value is from 1 to 32767. A value of -1 is a special case that creates the larg- 
est file possible on the device. 

/ALWAYS When you use this option with /BINARY or /SIPP:filespec:, the 
system creates an output file regardless of whether there are any differesnces 
between the two input files. This option is useful when running BATCH 
streams to prevent job step failures due to the absence of a DIFFEREN CES 
output file. 
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The /ALWAYS option is position dependent. That is, you must use it imme- 
diately after the output file to which you want it to apply. If you use it at the 
end of the command string, it applies to all output files. 

/AUDITTRAIL Use this o]3tion with /SLP to specify an audit trail. The 
/SLP option, described below, creates a command file which, when run with 
the source language patch program (SLP), can patch oldfile so it matches 
newfile. When you use SLP to modify a file, it creates an output file that has 
audit trails. An audit trail is a string of characters that appears in the right 
margin of each line that has been changed by the modification procedure. 
The audit trail keeps track of the patches you make to the patched source 
file. 

By default, SLP uses the following characters for the audit trail: 

When you use the /AUDITTRAIL option, the system prints the following 
prompt at the terminal. 

Audit trail? 

Enter a string of up to 12 ASCII characters that you want to use in place of 
the default audit trail. Do not use the slash (/) in the audit trail. 

/BINARY When you use thiis option, the system compares two binary files 
and lists the differences between them. This option is useful for comparing 
and relocatable image files (that is, machine runnable programs and object 
files) and provides a quick way of telling whether two files are identical. For 
example, you can use /BINARY to tell whether two versions of a program 
produce identical output. 

When you use /BINARY and do not specify an output file, the system prints 
output at the terminal according to the following general syntax: 

bbbbbb 000/ ffffff ssssss xxxxxx 

where: 

bbbbbb represents the octal block number of the block that 

contains the difference 

000 represents the octal offset within the block that con- 

tains the; difference 

ffffff represents the value in the first file you are comparing 

ssssss represents the value in the second file you are 

comparing 

xxxxxx represents the logical exclusive OR of the two values 

in the input files 

If you use the /OUTPUT:filespec option with /BINARY, the system stores 
the differences listing in the file you specify (if there are any differences 
found), instead of printing the differences at the terminal. 
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/BLANKLINES Use this option to include blank lines in the file com- 
parison. Normally, the system disregards blank lines. 

/BYTES When you use this option with /BINARY, the system lists the (dif- 
ferences byte-by-byte. 

/CHANGEB AR Use this option to create an output file that contains new- 
file with a changebar character next to the lines in newfile that differ from 
oldfile. The system inserts a vertical bar next to each line that has been 
added to newfile, and a bullet (lower-case letter o) next to each line that has 
been deleted. 

The output defaults to the terminal. Use the /PRINTER option to list the 
output to the line printer. Specify an output file with the /OUTPUT:filespec 
option. 

The sample that follows creates a listing of RTLIB.MAC with a changebar 
character at the left margin of each line that is different from RTLIB.BAK: 

H I FFE." RENCE S/CH ANGEH Al-i; RTl. 1 B . B AK y F!TL I B . MAC 

/COMMENTS When you use this option, the system includes in the file 
comparison all assembly language comments it finds in the two files. (Com- 
ments are preceded by a semicolon on the same line.) This is the deftiult 
operation. 

/NOCOMMENTS Use this option to exclude comments from the com- 
parison. (Comments are preceded by a semicolon on the same line.) This is 
useful if you are comparing two MACRO source programs with similar con- 
tent but different format. 

/END[:n] Use this option with /BINARY to specify the ending block num- 
ber of the file comparison, where n is an octal number that represents the 
ending block number. If you do not supply a value with /END, the sys tern 
defaults to the last block of the file or volume. 

/FORMFEED Use this option to include form feeds in the output listing. 
Normally, the system compares form feeds but does not include them in the 
output listing. 

/MATCH[:n] Use this option to specify the number of lines from each file 
that must agree to constitute a match. The value n is an integer in the range 
1-200. The default value for nis3. 

/OUTPUT:filespec Use this option to specify a device and file name for 
the output listing file. Normally, the listing appears on the console terminal. 
If you omit the file type for the listing file, the system uses .DIF. Note that 
the system creates this file only if there are any differences found. Use the 
/ALWAYS option if you want the system to create an output file regardless 
of whether any differences are found. 

/PRINTER Use this option to print a listing of differences on the printer. 
Normally, the listing appears on the console terminal. 
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/QUIET When you use this option with /BINARY, the system suppresses 
printing the differences at the; terminal and prints ?BINCOM-W -Files are 
different, if applicable. 

/SIF»P:filespec Use this option with /BINARY to output a file that you can 
use as an input command file to the save image patch program SIPP, where 
filespec represents the name of the output file. 

The file you create with /SIPP can patch oldfile so it matches newfile. 

The example that follows creates an input command file which, when run 
with SIPP, patches DEMOFl.BAK so it matches DEMOFl.SAV. 

niF-FERENCES/BitNARY/SIPPJPATCH.COM DEMOFl .BAK» HEMOf- 1 .SAW 

To execute the input command file created by /SIPP, see Chapter 22, Save 
Image Patch Program (SIPP). 

/SLP Use this option with /OUTPUT:filespec to create a command file 
that, when run with the source language patch utility SLP, patches oldfile to 
match newfile. If you do not use the /OUTPUT:filespec option with /SLP, the 
system prints the command file at the terminal. 

The sample that follows creates the command file PATCH.COM. 
PATCH.COM can be used as input to the program SLP to patch RTLIB.BAK 
so that it matches RTLIB.MAC. 

. D :t F FERii;:NCi;;: iii/SLP/ouTPUT % patc:h . com Rri... i b . bak y rtl i b . mac; 

To execute the command file you create with /SLP, see Chapter 24, Source 
Language Patch Program (SLP). 

/SPACES This option includes spaces and tabs in the file comparison. 
This is the default operation and is particularly useful when you are com- 
paring two text files and must pay careful attention to spacing. 

/NOSPACES Use this option to exclude spaces and tabs from the file com- 
parison. This is useful when you are comparing two source programs with 
similar contents but different formats. 

/START[:n] Use this option with /BINARY to specify the starting block 
number of the file comparison, where n represents the octal starting block 
number. If you do not supply a value with /START, the system defaults to 
the first block in the file. 

/TERMINAL Use this option to cause the list of differences to appear on 
the console terminal. This is the default operation. 

To understand how to interpret the output listing, first look at the following 
two text files. 

.TYPE FII...E:l. .TXT 

HERE'S A BOTTLE AND AN l-raNEKT FR:i:END! 



WHAT WAD Yi; 
WHA KENSk Bf! 



WISH FOR MAJRc MAN? 

ORE h:i:s life may end, 



WHAT HIS SHAME MAY BE 0' CARE. MAN? 
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THEN CATCH THE MOHENTS AS THEY FLY^ 
ANn USE THEM AS YE OUGHT c MANS 

BELIEVE ME» HAPPINESS IS SLY? 

AND COMES NOT AY WHEN SOUGHT!/ MAN. 



■SCOTTISH SONG 



•TYPE FILE2.TXT 

HERE'S A BOTTLE AND AN HONtiST FRIEND! 

WHAT WAD YE WISH FOR MAIR» MAN? 
WHA KENS? BEFORE HIS LIFE MAY ENDi- 

WHAT HIS SHARE MAY BE 0' CARE >■ MAN? 
THEN CATCH THE MOMENTS AS THEY FLYj. 

AND USE THEM AS YE OUGHT i. MAN J 

BELIEME ME» HAPPINESS IS SHY. 

AND COMES NOT AY WHEN SOUGHT » MAN. 



SCOTIISH SONG 



Notice that in the fourth line ofFILEl.TXT, shame should be share; in the 
seventh line, sly should be shy. 

The following command compares the two files, creating a listing file cailled 
DIFF.TXT. 

. D 1 1- f e r e n c e s / m a t c h : 1 / u t p u t s d I F p- . •( X I f 1 1... i;;: I . r X r !■ f i l i;;: 2 /r x t 

ySRCCOM-W ■Files are dif f erent 

The following listing shows file DIFF.TXT. 

•type DIFF.TXT 
U DK; FILEI.TXT 
2) DK;F ILF2.TXT 

1)1 WHAT HIS SHAME MAY BE 0' CARE* MAN? 

1) THEN CATCH THE MOMENTS AS THEY FLY» 

;')|. WHAT HIS SHARE MAY BE 0' CARE y MAN? 

2) THEN CATCH THE MOMENTS AS THEY FLYy 

>fr ^ ^ 4 ^ ^ ^ ^ ^ 4£ 

ni BELiEUE m:> happiness is sly» 

1) AND COMES NOT AY WHEN SOUGHT f MAN. 

2)1 BELIEVE MEy HAPPINESS IS SHY? 

2) AND COMES NOT AY WHEN SOUGHT v MAN. 

If the files are different, the system always prints the file name of each file as 
identification: 

1) DKSFILE1.TXT 

2) DK I FILE2.TXT 

The numbers at the left margin have the form n)m, where n represents; the 
source file (either 1 or 2) and m represents the page of that file on which the 
specific line is located. 

The system next prints ten asterisks and then lists the differences between 
the two files. The /MATCH:n option was used in this example to set to 1 the 
number of lines that must agree to constitute a match. 
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The first three lines of the song are the same in both files, so they do not 
appear in the listing. The fourth line contains the first discrepancy. The sys- 
tem prints the fourth line from the first file, followed by the next matching 
line as a reference. 

:L):I, what his shame may be Q' CAREy MAN? 

:l. ) THEN CATCH THE MOMENTS AS THEY FLYc 

The four asterisks terminate the differences section from the first file. 

The system then prints the fourth line from the second file, again followed 
by the next matching line as a reference: 

2):l. WHAT H:i:S SHARE MAY BE 0' CAREy MAN? 

2) THEN CATCH THE MOMENTS AS THEY FLYy 

The ten asterisks terminate the listing for a particular difference section. 

The system scans the remaining lines in the files in the same manner. When 
it reaches the end of each file, it prints ?SRCCOM-W-Files are different on 
the terminal. 

If you compare two files that are identical, the system does not create an out- 
put listing, but prints: 

? S R C C M •■■•:[■- N C) differs n c e s found 

/TRIM Use the /TRIM option with /SLP to ignore tabs and spaces that 
appear at the ends of source lines. This is the default setting. 

/NOTRJM Use /NOTRIM with /SLP to include in the comparison spaces 
and tabs that appear at the ends of source lines. /TRIM is the default setting. 
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The DIRECTORY command lists information you request about a device, a 
file, or a group of files. 




/OUTPUTrlilespec [/ALLOCATE:sizel 

(PRINTER 

/TERMINAL 



/BADBLOCKS (/FILES] [/STARTin] l/ENDm] I/VERIFY] [/WAIT] 

/DOS (/OWNER:|nnn,nnn]| 

/INTERCHANGE 

/TOPS 

/VOLUMEID |:ONLl 
/BEFORE [date] 
/DATE [datel 
/NEWFILES 
/SINCE [date] 

f/ALPHABETIZE [/REVERSE] 1 
{ /ORDER [xategory] [/REVERSE] } 
(./SORT |:categoryl I/REVERSE] J 

/BLOCKS 

/BRIEF 

/COLUMNS:n 

/DELETED 

/EXCLUDE 

/FAST 

/FREE 

/FULL 

/OCTAL 

/POSITION 

/SUMMARY 



In the command syntax shown above, filespecs represents the device, file, or 
group of files whose directory information you request. The DIRECTORY 
command can list directory information about a specific device, such as the 
number of files stored on the device, their names, and their creation dates. It 
can list details about certain files including their names, their file types, and 
their size in blocks. You can specify up to six files explicitly, but you can 
obtain directory information about many files by using wildcards in the: file 
specification. The DIRECTORY command can also print a device directory 
summary, organized in several ways, such as alphabetical or chronological. 

Normally, the DIRECTORY command prints listings in two columns on the 
terminal. Read these listings as you would read a book; read across the col- 
umns, moving from left to right, one row at a time. Directory listings that 
are sorted (with /ALPHABETIZE, /ORDER, or /SORT) are an exception to 
this. Read these listings as you would a telephone directory, by reading the 
left column from top to bottom, then reading the right column from top to 
bottom. 

The DIRECTORY command does not prompt you for any information. If'you 
omit the file specification, the system lists directory information alaout 
device DK:, as this example shows. 
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DIRECTORY 


.DIRECTORY 




















27-NOV-79 




















RTllSJ 


.SYS 




67P 


03-Jul- 


■79 


RTllFB 


.SYS 


SOP 


13- 


-A1J3-79 


RTHBL 


,SYS 




63P 


IS-Msr- 


-79 


DX 


.SYS 


3P 


13- 


-AUS3-79 


SWAP 


.SYS 




25P 


13-Aus- 


•79 


TT 


.SYS 


2P 


13- 


-Au^-79 


DP 


.SYS 




3P 


13-Au!3- 


■79 


DY 


.SYS 


4P 


13- 


-Aija-79 


LP 


.SYS 




2P 


27-Nov- 


■79 


PIP 


.SAy 


16 


25- 


-Jijl-79 


DUP 


.SAy 




41 


26-M3r- 


■79 


RESORC 


.SAV 


15 


13- 


■Aus -/y 


EDIT 


. SAV 




19 


13-Aua- 


■79 


STARTS. 


, COM 


1 


27- 


-Aug-79 


SIPP , 


.SAV 




14 


13-A1J3- 


■79 












15 Pi] 


Les t 


413 Blocks 














73 Free bl 


0(:^ 


'•. s 

















A "P" next to the block size number of a file's directory entry indicates that 
the file is protected from deletion (see RENAME/PROTECTION). 

If you specify only a device in the file specification, the system lists directory 
information about all the files on that device. If you specify a file name, the 
system lists information about just that file, as this example shows. 

.DIRECTORY DXO : RTl IFB . SYS 

lO-Dec-79 
RTllPB.SYS BOP 13-AUS-79 

1 Filej 80 Blocks 

4 Free blocks 

The following sections describe the options you can use with the DIREC- 
TORY command and provide; sample directory listings. Some of the options 
accept a date or part of a dat(; as an argument. The syntax for specifying the 
date is: 

[:dd][:mmm][:yy] 

where: 

dd represents the day (a decimal integer in the range 

1-31) 

mmm represents the first three characters of the name of 

the mcinth 

yy represents the year (a decimal integer in the range 

73-99) 

The default value for the date is the current system date. If you specify just 
the; day, the system interprets it as the given day of the current month and 
year. If you specify just the month, the system interprets it to be the first day 
of the given month in the current year. If you specify only the year, the sys- 
tem interprets it as the start of that year. If the current system date is not 
set, it is considered (the sarae as for an undated file in a directory listing). 

If you have selected timer support through the system generation process, 
but have not selected automatic end-of-month date advancement, make sure 
that you set the date of the beginning of each month with the DATE com- 
mand. If you fail to set the deite at the beginning of each month, the system 
prints -BAD- in the creation date column of each file created beyond the end- 
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of-month. (Note that you can eliminate -BAD- by using the RENAIVCE/ 
SETDATE command after you set the date.) 

/ALLOCATE:size Use this option with /OUTPUT to reserve space on the 
device for the output listing file. The argument size represents the numlaer 
of blocks of space to allocate. The meaningful range for this value is from 1 
to 32767. A value of -1 is a special case that creates the largest file possible 
on the device. 

/ALPHABETIZE This option lists the directory of the device you specify 
in alphabetical order by file name and file type. It has the same effect as the 
/ORDER:NAME option. Note that this option sorts numbers after letters, 

/BADBLOCKS Sometimes devices (disks and DECtapes) have bad blocks, 
or they develop bad blocks as a result of use and age. Use the /BADBLOCKS 
option to scan a device and locate bad blocks on it. The system prints 1;he 
absolute block number of these blocks on the devices that return hardware 
errors when the system tries to read them. This procedure does not destroy 
data that is already stored on the device. Remember that block numbers are 
listed in both octal and decimal and the first block on a device is block 0. If a 
device has no bad blocks, an informational message prints on the terminal. 

. D I R i:;: c r r y / b a d b i... o c; k s d x :i. : 

?DUP-:i:-No bad blocks detected 

If /BADBLOCKS is the only option in the command line, the volume being 
scanned does not need a valid RT-11 directory structure. 

/BEFORE[date] This option prints a directory of files created before the 
date you specify. The following command lists on the terminal all files stored ' 
on device DXl: that were created before December 1979. 



, DIRECTOR Y/BE 


FORE t DEC DX:l 


i. ; 












14 -Dec -7 9 


















MYPROG.MAC 




36P :L9-Nov 


"79 


TM .MAC 


2S 


27^^ 


• N o V ■■ 


••79 


VIM AC .MAC 




7 :I.9--N(:jv 


•79 


SYSMAC.MAC 


41 


19- 


•■Nov 


•79 


RT:L:lSJ.SYS 




1 9 -Nov 


■■79 


RT113J.SYS 


67 


19 


- N o V ■• 


-79 


rr .SYS 




2 :l,9-Nov 


•79 


DX .BY3 


3 


19- 


-Nov^^ 


-79 


BUILD .MAC 




:l.00 :l.9-Nov 


•79 












9 F:j. :i.Bsy :; 


>S:l, 


Blocks 















180 Free blocks 

/BEGIN This option lists the directory of the device you specify, beginning 
with the file you name and including all the files that follow it in the direc- 
tory. The occurrence of file names in the listing is the same as the order of 
the files on the device. 

The following example lists the file VTMAC.MAC on device DXO: and all 
the files that follow it in the directory. 
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DIRECTORY 


.DIRECTORY 


tiXO 


:vtmac.mac/bie:gin 










lO-Dec-79 
















yiMAC .MAC 




15 


lO-Ausi-7'? 


DIR 


• SAV 


17 


03-Aij^-79 


RK .SYS 




3 


13--Aua-7'? 


EDIT 


.SAV 


19 


03-A1JS-79 


STARTS.COM 




1 


27--Aua-7'? 


DD 


.SY3 


5 


19- Aij^-79 


SRCCOM.SAU 




13 


13-Au2~7V 


BINCOM 


.SAW 


11 


0!v-Oct -79 


SLP .SAV 




9 


13--AUS--79 


SIPP 


,5M 


14 


05-Oct- 79 


10 Files f 


107 


Bl 


ocKs 
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/BLOCKS This option prints a directory of the device you specify and 
includes the starting block number in decimal (or in octal if you use 
/0(;!TAL) of all the files listed. The following example lists the directory of 
DXO:, including the starting block numbers of files. 

.DIRECTORY/BLOCKS nXO: 

14-Dec-79 

FSM .MAC 31P 19-NOV-7? 2955 BATCH .MAC 102P 19-Nov-79 2986 

ELCOPY.MAC 8P 19-Nov-7<' 3088 ELIMIT . MAC 15P 19Nov-;'? 3096 

ELTASK'.MAC 15P 19-Nov~79 3111 ERROUT.MAC 48P 19-Nov~79 3126 

ERRTXT.MAC 9P 19~Nov-79 3174 3YCND . BL 3P 19-Nov-79 31(33 

SYSTBL.BL 4P 19-Nov~79 3186 SYCND .DllS 5P 19-Nov-79 3190 

SYSTBL.mS 4P 19-NOV-79 3195 SYCND .HB 5P 19-Wov-79 3199 

ABSLOD.SAV 48 15-M3r-76 3204 CHESS ,SM 40 17-"Au^-75 3252 

PETAL .SAV 36 ll-Sep-7:5 3292 LAMP .SAM 29 16-Mst-79 3328 

UUMPUS.SAV 30 16-Msr-79 3357 

17 Filesr 348 Blocks 

138 Free ti locks 

/BRIEF This option lists only file names and file types, omitting file 
lengths and associated dates. It produces a five-column listing, as the follow- 
ing example shows. 

.DIRECTORY/BRIEF RKl! 
14~riec-79 



SWAP .SYS 


RT113J 


.SYS 


RTUFB 


.SYS 


RTllBL 


,SYS 


TT 


.SYS 


DT .SYS 


DP 


.SYS 


DX 


.SYS 


[lY 


.SYS 


RF 


.SYS 


RK .SYS 


DL 


.SYS 


DM 


.SYS 


DS 


.SYS 


DD 


.SYS 


LP .SYS 


L3 


.SYS 


CR 


.SYS 


MS 


.SYS 


MTHD 


.SYS 


BISMT1.COM 


MMHD 


.SYS 


NUMBER 


.PAS 


ULOCK 


.SAV 


MYPROG 


.MAC 


PROG .MAP 


ANTONY 


.BAK 


MSHD 


,SYS 


NL 


.SYS 


PC 


■ SYS 


PD .SYS 


CT 


.SYS 


BA 


.SYS 


MY PROG 


.SAV 


ODT 


.SAV 


35 Filesj 


408 Block 


B 














78 Free bl 


ocks 

















/COLUMNS:n Use this option to list a directory in a specific number of 
columns. The value n represents an integer in the range 1-9. Normally, the 
system uses two columns for regular listings and five columns for brief list- 
ings. The following example lists the directory information for device DXl: 
in one column. 
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,DIRECTORY/COLUMNS:i DXi: 

29-NOV-79 
SWAP .SYS 25P 19-NOV-79 

RTUSJ.SYS 67P 19-Mov-77 

RTUrB.SYS 80P 19-Nov-79 

RTllBL.SYS SAP 19-Nov'79 

TT .SYS 2P \9-Hov-79 

DT .SYS 3P 19 -Nov -77 

DP .SYS 3P 19-NGV-79 

7 Files» 244 Blocks 

242 Free blocks 



/DATE[date] Use this option to include in the directory listing only those 
files with a certain date. The following command lists all the files on device 
DXO: that were created on 13 August 1979. 



.DIRECTORY/DATE t 13 : AUG ! 79 DXO 1 
15-Sep-79 



RTllSJ 


.SYS 




67P 


;l3-Au£S- 


-7? 


RTllFE 


. EYB 


SOP 


13- 


-AuS- 


-79 


RTllBL 


.SYS 




63P 


13 -Au!3- 


-79 


DX 


.SY3 


3P 


13- 


-AuiS 


-79 


SWAP 


.SYS 




25P 


13-Ausi- 


■79 


TT 


• SYS 


2P 


13 


•Aua- 


-79 


DP 


.SYS 




3P 


13-Aij<3- 


-79 


DY 


.SYS 


4P 


1.3- 


■Ausi- 


-,"? 


LP 


.SYS 




2P 


13-Aija- 


-79 


PIP 


.SAV 


16 


13 


■Aust- 


-79 


DUP 


.SAV 




41 


13 -Aug- 


-79 


RESORC 


.SAV 


15 


i:5- 


Au<.3 


-77 


DIR 


.SAV 




17 


13-Au!3- 


-79 


RK 


, SYS 


3 


13- 


■AuS- 


-79 


EDIT 


.SAV 




19 


13-Aija 


-79 


DD 


.SYS 


5 


1 3 - 


-Ausi 


•79 


SRCCOM 


.SAV 




13 


13-Au^- 


-79 


BINCOM 


.SAV 


11 


13- 


■Au^- 


-79 


SLP 


.SAV 




9 


13--Aua- 


-79 


SIPP 


.SAV 


14 


13- 


-Ausi- 


79 


20 Fi 


les t 


41 


2 Blocks 
















73 Free bl 


oc 


ks 



















/DELETED This option lists a directory of files that have been deleted 
from a specific device, but whose file name information has not been 
destroyed. The listing includes the file names, types, sizes, creation deites, 
and starting block numbers in decimal of the files. The file names that print 
also represent tentative files. The listing can be useful in recovering files 
that have been accidentally deleted. Once you identify the file name and 
location, you can use the CREATE command or DUP to rename the area 
(see Section 8.2.1 for this procedure). The following command lists files on 
device DXO: that have been deleted. 



.DIRECTORY/DELETEr 


DXO! 




















14-Dec-79 
























SYSGEN.CND 


11 


19-Nov- 


-79 


1403 


TS 


.MAC 


2 


27- 


-Nov- 


-79 


2895 


TM .MAC 


26 


19 -Mov 


-79 


2926 


MT 


.SYS 


32 


27- 


-Nov 


-79 


3415 


468DAT.DIR 


1 


14-Dec- 


-79 


3701 


468DEL 


• DIR 


527 


14- 


-Dec- 


-79 


3704 


NUM2 .MAC 


4 


21-Nov 


-79 


4231 


NUM2 


.LST 


565 


06- 


Sep- 


-79 


4235 


Filesi 


Blocks 






















1164 Free 


block a 























Note in the example shown above that, since a deleted file does not really 
exist, the total number of files and blocks is 0. 

/DOS Use this option to list the directory of a device that is in RSTS/E or 
DOS format. The only other options valid with /DOS are /BRIEF, /Fi'i.ST, 
and /OWNER. The valid devices are DECtape for RSTS/E and DOS, and 
RK05 for DOS. 
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/END:n Use with /START:n and /BADBLOCKS to specify the last block 
number of a bad block scan. If you do not specify /END:n, the system scans to 
the last block on the volume. 

/EXCLUDE This option lists a directory of all the files on a device except 
those files you specify. The following example lists all files on DXO: except 
the .SAV and .SYS files. 

.DIRECTORY/EXCLUDE DXO ! ( * . SAW » * . SYS ) 



29-0ct-79 




















RTl ISJ.MAC 


67P 


06-Sep- 


-79 


RTllFB 


.MAC 


80P 


06- 


-Sep- 


-79 


RTUBL.MAC 


A3P 


06-Sep- 


-79 


DX 


.MAC 


3P 


06- 


•Sep- 


-79 


SWAP ,MAC 


25P 


06 -Sep- 


-79 


TT 


.MAC 


2P 


06- 


-Sep- 


-79 


DP .MAC 


3P 


06-Sep- 


-79 


tiY 


.MAC 


4P 


06- 


-Sep- 


-79 


LP .MAC 


2P 


06-Sep- 


-79 


RK 


• MAC 


3 


06- 


-Sep- 


-79 


STARTS.COM 


1 


27--A1J3- 


-79 


riD 


.MAC 


5 


06- 


. Sep - 


-79 


12 Files. 


258 Blocks 
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/FAST This option lists only file names and file types, omitting file lengths 
and associated dates. This is the same as /BRIEF. 

/FILES Use this option with /BADBLOCKS to print the file names of bad 
blocks. If the system does not find any bad blocks, it prints only the heading, 
as the following example shows. Do not use this option if the volume is not a 
standard RT-11 directory-structured volume or if the volume does not con- 
tain an RT-11 directory. 

. riTRECTORY/BADBLOCKS/n:LES nil J 
?DUP-I-No bad bil.ocks detected DT:I. S 

/FREE Use this option to print a directory of unused areas and the size of 
each. This example lists the unused areas on device DK:. 



UWUSEIi > 2 

UNUSED > 32 

UNUSED > 525 

UNUSED > 56;:^ 



/FULL This option lists the entire directory, including unused areas and 
their sizes in blocks (decimal). The following example lists the entire direc- 
tory for device DXO:. 



.DIRECTORY/FREE 


14-Dec-79 




< UNUSED > 


11 


< UNUSED > 


26 


< UNUSED > 


1 


< UNUSED > 





Files. 


Blocks 


1162 Free 


block's 
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.DIRECTORY/FULL DXO: 














14-Dec-79 


















SWAP .SYS 


25P 


23-Oci- 


-79 


RTllSJ 


.SYS 


6 7P 


23- 


"0ct~79 


RTllFB.SYS 


BOP 


19-Nov 


-79 


RTllBL 


.SY!:! 


6 4P 


]9- 


-Nov- 7 9 


TT .SYS 


2P 


19- Nov 


-79 


DT 


.SYS 


:iP 


19- 


■Nov -79 


Vf .SYS 


3P 


23-Oct- 


-79 


nx 


.SYS 


SF 


19. 


-Nov-79 


DY .SYS 


4P 


19-Nov- 


-79 


RF 


.SY3 


3P 


19- 


■Nov -79 


RK .SYS 


3P 


19-Nov- 


-79 


DL 


.SYS 


4P 


23 


-Oct -79 


DM ,SYS 


5P 


23-Oct- 


-79 


DS 


.SYS 


3P 


19- 


-Nov- 79 


DD .SYS 


5P 


23-Oct- 


-79 


LP 


.SYS 


2P 


2o- 


-Oct -7? 


LS .SYS 


2P 


19-Nov- 


-79 


CR 


.SYS 


3P 


19- 


-Nov-79 


MS .SYS 


9P 


2?-Nov- 


-79 


MTHD 


.SYS 


3P 


23- 


-Oct -79 


DISMT1.COM 


9P 


27-Nov 


-79 


MMHD 


.SYS 


4P 


19- 


-Nov-79 


NUMBER. PAS 


1 


11-Dec- 


-79 


TONY 


.AGP 


14 


17- 


~Ar,j3~79 


NUM3 .LST 


1 


13-Dec- 


-79 


< UNU3 


ED > 


5<fi5 






25 Files; 


322 Blocks 














164 Free t 


ilocks 

















/INTERCHANGE Use this option to list the directory of a diskette that is 
in interchange format. The only other options valid with /INTERCHANGE 
are /BRIEF and /FAST. 

/NEWFILES This option includes in the directory listing only those files 
that were created on the current day. This is a convenient way to list the 
files you created in one session at the computer. The following command 
lists the new files on 19 May 1979. 

.DIRECTORY/NEUFILES DTOS 

19~Mi3« -79 
FIL.E1 .TXT 1 19 -May -79 FILE2 .TXT 1 19 "M3H-79 

2 Files y 2 Blocks 

328 Fr-GG blocks 

/OCTAL This option lists the sizes (and starting block numbers if you slIso 
use /BLOCKS) in octal. If the device you specify is a magtape or cassette, the 
system prints the sequence numbers in octal. The following example shows 
an octal listing of device DXO:. 



.DIRECTORY/OCTAL DXOJ 
















14-Dec-79 


Dc 


rial 


















MYPROG.MAC 




44P 


12-Nov- 


-79 


TM 


.MAC 


31 


■'!> '7 ■■ 


•Nov- 


-79 


VTMAC .MAC 




7 


18-Oct 


-79 


SYSMAC 


.MAC 


51 


19. 


-Nov- 


-79 


SWAP .SYS 




31 


05 -Sep- 


-79 


ANTON 


.MAC 


4 


19- 


-Nov- 


-79 


RTllSJ. SYS 




103 


19-Nov- 


-79 


TT 


.SYS 


2 


19- 


-Nov- 


-79 


DX .SYS 




3 


29-AijS- 


-79 


BUILD 


.MAC 


144 


19- 


-Nov- 


-79 


10 Filesj 




462 


Blocks 
















264 Free 


block 


s 

















/ORDER[:category] This option sorts the directory of a device according 
to the category you specify. Table 4-3 summarizes the categories and their 
functions. 
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Table 4-3: Sort Categories 



Category 



Function 



DATE 

NAME 

POSITION 

SIZE 

TYPE 



Sorts the directory chronologically by creation date. Files that have the same 
date are sorted alphabetically by file name and file type. 

Sorts the directory alphabetically by file name. Files that have the same file 
name are sorted alphabetically by file type (this has the same effect as the 
/ALPHABETIZE option). 

Lists the files according to their position on the device (this is the same as 
using /ORDER with no category). 

Sorts the directory based on file size in blocks. Files that are the same size are 
sorted alphabetically Ijy file name and file type. 

Sorts the directory alphabetically by file type. Files that have the same file 
type are sorted alphabetically by file name. 



The following examples list the directory of device DXO:, according to each 
of the categories. 



.DIRECTORY/ 


'ORDER J DATE DXO! 












XA-liec-79 














BUILD .MAC 


100 06-Sep-79' 


SYSMAC.MAC 


41 


19- 


-Nov- 


-79 


DX .SYS 


3 06-Sei='-79 


TT .SYS 


2 


19- 


-Nov 


-79 


MYPROG.MAC 


36P 1,2-0ct-79 


VTMAC .MAC 


7 


19- 


-Nov- 


-79 


RFUNCT.MAC 


4 19-NOV-75' 


TM .MAC 


25 


27- 


-Nov 


-79 


RTllSJ.SYS 


67 19-NOV-79 


SWAP .SYS 


25 


05- 


-Dec- 


-79 


10 Filesr 


306 Blocks 













180 Free blocks 



directory/order: NAME DXO: 
14 -:Ciec-"79 

100 
3 
36P 

4 
67 



BUILD .MAC 
DX .SYS 
MYPROG.MAC 
RFUNCT.SYS 
RTllSJ.SYS 
10 Files, 



06 -Sep-79 
06-Sep-79 
12-0ct-79 
19-NOV-79 
19-NOV-79 



SWAP .SYS 


25 


05- 


-Dec- 


-79 


SYSMAC.MAC 


41 


19- 


■Nov- 


-79 


TM .MAC 


25 


27- 


-Nov- 


■79 


TT .SYS 


2 


19- 


-Nov 


-79 


VTMAC .MAC 


7 


19- 


-Nov- 


-79 



306 Block! 



180 Free blocks 



.niRECTORY/ORDERJPOSITION DXO: 














14~Dec-79 
















RTllSJ.SYS 


67 19-Nov~79 


BUILD 


.MAC 


100 


06 


■Se-r- 


■79 


DX .SYS 


3 06-3t>p-79 


SYSMAC 


.MAC 


41 


19 


Nov 


■79 


MYPROG.MAC 


36P 12-0ct~79 


TM 


.MAC 


25 


27- 


"Nov- 


■79 


SWAP .SYS 


25 05~Dec-79 


yTMAC 


.MAC 


7 


19 


-Nov 


•79 


RFUNCT.SYS 


4 19-NOV-79 


TT 


.SYS 


■7 


19- 


-Nov- 


-79 


10 Files, 


306 Blocks 














180 Free blocks 
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.directory/order: 


SIZE DXO! 














14-Dec-79 


















TT .SYS 


2 


19-NOV-79 


SWAP 


.SYS 


25 


05- 


-Dee 


■79 


DX .SYS 


3 


06-Sep-79 


MYPROG 


.MAC 


36P 


12- 


■Oct- 


-7? 


RFUNCT.SYS 


4 


19-NOV--79 


SYSMAC 


.MAC 


41 


19- 


-Nov- 


-79 


VTMAC .MAC 


7 


19-NOV-79 


RTllSJ 


.SYS 


67 


19- 


-Nov 


■/•; 


TM .MAC 


25 


27-NOV-79 


BUILD 


.MAC 


100 


06- 


-Sep 


■/9 


10 Files» 306 Bl 


ocks 














180 Free blocks 
















.directory/order: 


TYPE DXO J 














14-Dec-79 


















BUILD .MAC 


100 


06-Sep-79 


DX 


.SYS 


3 


06- 


-Sep 


■79 


myprog.mac 


36P 


12-0ct-79 


RFUNCT 


.SYS 


4 


19- 


-Nov 


-79 


SYSMAC.MAC 


41 


19-NOV-79 


RTllSJ 


.SYS 


67 


19- 


-Nov- 


-79 


TM .MAC 


25 


27-NOV-79 


SWAP 


.SYS 


25 


05- 


-Dec 


■79 


VTMAC .MAC 


7 


19-NOV-79 


TT 


.SYS 


2 


19- 


-Nov- 


-79 


10 Filesr 


306 Bl 


ocks 















180 Free blocks 

/OUTPUT:filespec Use this option to specify a device and file name for 
the output Hsting file. Normally, the directory listing appears on the console 
terminal. If you omit the file type for the listing file, the system uses .DIR. 

/OWNER:[nnn,nnn] Use this option with /DOS to specify a user identi- 
fication code (UIC). Note that the square brackets are part of the UIC; you 
must type them. 

/POSITION Use this option to list the file sequence numbers of files stored 
on a magtape. See /COLUMNS:n for a sample listing. 

/PRINTER Use this option to print the directory listing on the line 
printer. The default output device is the terminal. Note that the /PRINTER 
option does not use the QUEUE program to queue the directory listing. 

/REVERSE This option lists a directory in the reverse order of the sort 
you specify with /ALPHABETIZE, /ORDER, or /SORT. The following exam- 
ple sorts the directory of DXO: and lists it in reverse order by size. 

,DIRECT0RY/0RDER!SI7.E/REVERSE DXO: 



14-Dec-79 














BUILD .MAC 


100 06-Ser'-79 


TM .MAC 


25 


27- 


-Nov- 


-79 


RTllSJ. SYS 


67 19-NOV-79 


VTMAC .MAC 


7 


19 


-Nov- 


-79 


SYSMAC.MAC 


41 19-NOV-79 


RFUNCT.SYS 


4 


19- 


-Nov- 


-79 


MYPROG.MAC 


36P 12-0ct-79 


DX .SYS 


3 


06- 


-3©p- 


-79 


SWAP .SYS 


25 05-Dec-79 


TT .SYS 


2 


19- 


-Nov- 


-79 


10 Filesr 


306 Blocks 













180 Free blocks 



/SINCE[date] This option lists a directory of all files on a specified device 
that were created on or after a specified date. The following command lists 
only those files on DK: that were created on or after 13 August 1977. 
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DIRECTORY 


.niRECrORY/S 


iNCEt 13JAUG:79 










14--i:iec-79 












RTllSJ.SYS 


67P 14-A.jg-79 


RTUFB 


• SYS 


SOP 


02-Sep-79 


RTllBL.SYS 


63P 19-AUS--79 


DX ' 


.SYS 


3P 


lO-Sep-79 


SWAP .SYS 


25P 02- Sep- 79 


TT 


.SYS 


2P 


15-Sep-79 


SIPP .SAV 


14 02-Sep-79 










7 Files. 15 


4 Blocks 










332 Free bl 


ochs 











/SORT[:category ] This option sorts the directory of a device according to 
/the category you specify. It is the same as /ORDER[: category]. 

/START[:n] Use this option with the /BADBLOCKS option to specify the 
starting block, and optionally the last block if you use /END:n, of the bad 
block scan. The argument n represents a block number in decimal. If you do 
not supply a value with /START, the system scans from the first block on the 
volume. If you do not specify /END:n, the system scans to the end of the 
volume. 

/SUMMARY This option lists a summary of the device directory. The 
summary lists the number of files in each segment and the number of seg- 
ments in use on the volume you specify. The /SUMMARY option does not 
list the segments in numerical order, only the order in which they are linked 
on the volume. The following example lists the summary of the directory for 
device DK:. 

.DIRECTORY/SUMMARY 
14-NOV-/9 

■44 F'lles in seamerit 1 

46 Files in seslmerit, 4 

37 Files in segment 2 
34 Files in ssivamenl Ti 

38 Files in segment 3 

16 Available seSment? . 5 iu use 

199 Files. 3647 lUoc-ks 
1115 Free b 1 o c k is 

/TERMINAL This option lists directory information on the console termi- 
nal. This is the default operation. 

/TOPS Use this option to list the directory of a DECtape that is in DEC- 
system-10 format. The only other options valid with /TOPS are /BRIEF and 

/FAST. 

/VERIFY Use this option with the /BADBLOCKS option to read a bad 
block, write to it, and read it again. If the system can not read the block, it 
reports a hard error. If the block recovers, it reports a soft error. This pro- 
cedure does not destroy data already on the volume. 

Use this option only when necessary; DIGITAL does not guarantee the 
integrity of the data recovered from a soft bad block error. 
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/VOLUMEID[:ONLY] Use /VOLUMEID to print the volume ID and 
owner name along with the directory listing of the storage volume. If you 
include the optional argument, ONLY, the system prints only the volume ID 
and owner name. 

The following example displays the volume ID of volume DKl: 



.DIRCCTORY/VOLUMFin nXl*. 
















14-Dec~79 


















Volume id; 


BACKUP2 
















Owner ! 


Mar c 'A 
















SWAP .SYS 


25P 19~Nov- 


-79 


RTllSJ 


. SYB 


6 7P 


19- 


-Nov- 


-79 


RTllFB.SYS 


80P 19-Nov- 


-79 


RTllBL 


.SY3 


64P 


19- 


-Nov 


-79 


TT .SYS 


2P 19-Nov- 


-79 


DT 


.SYS 


3P 


19- 


-Nov 


■7? 


DP .SYS 


3P 19-Nov 


-79 


DX 


.SYS 


3P 


1<5. 


■ N o V 


■7'? 


DY .SYS 


4P 19-Nov- 


-79 


RF 


.SYS 


3P 


19- 


-Nov- 


-79 


RK .SYS 


3P 19-Nov 


-79 


DL 


. 3YS 


4P 


19 


-Nov 


- 7 ',' 


12 Files* 


271 Blocks 
















215 Free blocks 

















/WAIT Use with the /BADBLOCKS option when you want the system to 
initiate a bad block scan but to pause for you to mount the input volume. 
This option is particularly useful if you have a single-disk system. When you 
use this option, and the system volume is mounted, the system initiates the 
operation you specify, then prints Mount input volume in <device>; Con- 
tinue?. The prompt <device> represents the device into which you mount 
the volume. Mount your input volume and type Y, followed by a carriage 
return. 

The following sample performs a bad block scan on an RK05 disk. 

DIRECTORY/IaIA IT/BAIiBLOCKS RKO i 
Mount input volume :i.n RKO J Continue? Y 
'I' D I J I-' ~ I - N o b ill d b 1 o c^ k. <:; d e t e c; t e d R K ! 
Mount system volume in RKO! Continue? Y 



.^ff™™*^^!)* 
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The DUMP command can print on the terminal or line printer, or write to a 
file all or any part of a file in octal words, octal bytes, ASCII characters, 
and/or Radix-50 characters. It is particularly useful for examining direc- 
tories and files that contain binary data. 



DUMP 


r /OUTPUT:fllespec [/ALLOCATE:size] 

/PRINTER 
i /TERMINAL J 

/:N01 ASCII 

/BYTES 

/IGNORE 

/ONLYlblock 

/RAD50 

[/STARTrblock] [/ENDiblock] 

/WORDS 


( SP) fllespec 



In the command syntax shown above, filespec represents the device or file 
you want to examine. If you do not specify an output file, the listing prints 
on the line printer. If you do not specify a file type for an output file, the sys- 
tem uses .DMP. You can specify the entire command on one line, or you can 
rely on the system to prompt you for information. The DUMP command 
prompt is Device or file?. 

Notice that some of the options (/ONLY, /START, and /END) accept a block 
number as an argument. Remember that all block numbers are in octal, and 
that the first block of a device or file is block 0. To specify a decimal block 
number, follow the number with a decimal point. If you are dumping a file, 
the block numbers you specify are relative to the beginning of that file. If 
you are dumping a device, the block numbers are the absolute (physical) 
block numbers on that device, 

The system handles operations involving magtape and cassette differently 
from operations involving random-access devices. If you dump an RT-11 
file-structured tape and specify only a device name in the file specification, 
the system reads only as far as the logical end-of-tape. Logical end-of-tape is 
indicated by an end-of-file label (EOFl) followed by two tape marks. For 
non-file-structured tape, logical end-of-tape is indicated by two consecutive 
tape marks. If you dump a cassette and specify only the device name in the 
file specification, the results are unpredictable. For magtape dumps, tape 
mark messages appear in the output listing as the system encounters them 
on the tape. 

NOTE 

The DUMP operation does not print data from track of 
diskettes. 

The following sections describe the options you can use with the DUMP com- 
mand. Following the options are some sample listings and an explanation of 
how to interpret them. 
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/ALLOCATE:size Use this option with /OUTPUT to reserve space on the 
device for the output listing file. The argument size represents the number 
of blocks of space to allocate. The meaningful range for this value is from 1 
to 32767. A value of -1 is a special case that creates the largest file possible 
on the device. 

/ASCII This option prints the ASCII equivalent of each octal word or byte 
that is dumped. A dot (.) represents characters that are not printable. This is 
the default operation. 

/NO ASCII Use this option to suppress the ASCII output, which appears in 
the right hand column of the listing (or below the bytes if you have specified 
/BYTES). This allows the listing to fit in 72 columns. 

/BYTES Use this option to display information in octal bytes. The sys1;em 
does not display words unless you also use /WORDS. 

/END:block Use this option to specify an ending block number for the 
dump. The system dumps the device or file you specify, beginning with block 
(unless you use /START) and continuing until it dumps the block you s]3ec- 
ify with /END. 

/FOREIGN Use this option to dump a magtape that is not RT-11 file- 
structured. 

/IGNORE Use this option to ignore errors that occur during a dump ojper- 
ation. Use /IGNORE if an input or output error occurred when you tried to 
perform a normal dump operation. 

/ONLY:block Use this option to dump only the block number you specify. 

/OUTPUT:filespec Use this option to specify a device and file name for 
the output listing file. Normally, the listing appears on the line printer. If 
you omit the file type for the listing file, the system uses .DMP. 

/PRINTER This option causes the output listing to appear on the line 
printer. This is the default operation. 

/RAD50 This option prints the Radix-50 equivalent of each octal v^ord 
that is dumped. 

/STARTiblock Use this option to specify a starting block number for the 
dump. The system dumps the device or file, beginning at the block number 
you specify with /START and continuing to the end of the device or file 
(unless you use /END). 

/TERMINAL This option causes the output listing to appear on the con- 
sole terminal. Normally, the listing appears on the line printer. 

/WORDS This option displays information in octal words. This is the 
default operation. 

The following command dumps block 1 of the file SYSMAC.MAC. The out- 
put listing, which shows octal bytes and their ASCII equivalent, is stored in 
file MACLIB.DMP. The PRINT command prints the contents of the file on 
the line printer. 
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. DUMP/OUTPUT SMACI... IB/BYTES/ONLY X 1, SYSMAC . MAC 
.PRINT MACLTB.DMP 



6Y:SYaMAC.MAC 

BLOCK hUHBEK 00001 

000/ UO 040 117 1U6 04U 

P F 

020/ 101 122 10b 040 040 

A H E 

040/ 012 073 040 124 122 

; T H 

060/ 012 073 01b 012 073 

100/ 101 124 HI 117 lib 

A T I In 

120/ 10b 124 127 101 122 

f I if, A R 

140/ 124 040 124 117 U40 

T TO 

160/ no 117 12b 12^ 040 

H U T 

200/ 101 lit), 104 040 04o 

A N Li 

220/ 040 040 102 lob 040 

B t 

240/ 040 101 123 040 040 

A a 

260/ 124 040 102 131 04O 

1 a y 

300/ 111 120 lib 105 Uh 

1 f M h; iM 

320/ 101 124 111 117 Uh 

A T I W 

340/ 111 124 101 114 040 

1 T A L 

360/ 122 10b 123 120 ll7 

R £ S P (J 

400/ 117 122 040 l/t 110 

UK 1 H 

420/ 105 114 111 101 102 

h. L I A tJ 

440/ 111 124 123 01b 012 

ITS 

460/ 117 116 040 iob 121 

ON f J 

500/ 103 110 040 111 123 

C H IS 

520/ 105 104 040 102 131 

ED By 

540/ 014 056 115 101 103 

MAC 

560/ 056 115 103 101 114 

M C A L 

600/ 056 103 lib 061 054 

C M 1 

620/ 115 063 054 056 056 

M 3 » . . 

640/ 054 056 056 056 103 

# • » * c 

660/ 015 012 056 105 116 

700/ 117 040 056 056 126 

V 

720/ on 056 056 056 103 

• • • « C 
740/ 056 05.6 103 115 062 

C M 2 

760/ 103 115 064 054 056 

C M 4 , . 
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124 
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123 
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Olb 
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S 
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B 
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. 
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123 
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10b 


122 
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10b 


104 


Obb 


015 


A 


H 


^ 


t 


E 


K 


R 


E 


D 


, 


• 


040 


124 


110 


10b 


040 


HI 


116 


10b 


117 


122 


115 




T 


ri 


L 
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R 
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040 
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040 


124 


HO 
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123 


040 
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I 


N 
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H 


1 


S 




& 





10b 


040 


111 


123 


040 


123 


12b 


10/: 


112 


10b 


103 


t: 




I 


b 




3 


U 


b 


J 


E 


C 


103 


110 


101 


lib 


107 


lOb 


040 


040 


127 


HI 


1^4 


C 
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H 


VJ 


t 






w 


i 


1 


040 
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117 


124 


111 
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040 
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In the printout above, the heading shows which file was dumped and which 
block of the file follows. The numbers in the leftmost column indicate the 
byte offset from the beginning of the block. Remember that these are all 
octal values, and that there are two bytes per word. The octal bytes that 
were dumped appear in the next eight columns. The ASCII equivaleiat of 
each octal byte appears underneath the byte. The system substitutes a dot (.) 
for nonprinting codes, such as those for control characters. 

The last example shows block 6 (the directory) of device RKO:. The output is 
in octal words with Radix-50 equivalents below each word. 

. rnjMP/NOASc;i: i/F;:AD50/aNi... Y ; 6 rko j 



HKO: 


^N/X/O: 


3 














BLUCK NUMBER 0000b 












000/ 


000020 


000002 


000004 


OOOOOO 


000046 


002000 


075131 


062000 




P 


B 


D 




8 


YX 


SMA 


P 


020/ 


075273 


000031 


OOOOOO 


027147 


002000 


071677 


142302 


075273 




SK5 


Y 




GP9 


YX 


RTl 


ISJ 


SYS 


040/ 


000103 


OOOOOO 


027147 


002000 


071677 


141262 


075273 


000120 




A$ 




GP9 


YX 


RTl 


1KB 


SYS 


B 


060/ 


000000 


027147 


002000 


071677 


141034 


075273 


000100 


OOOOOO 






GP9 


YX 


RTl 


IBL 


SYS 


AX 




100/ 


027147 


002000 


100040 


OOOOOO 


075273 


000002 


OOOOOO 


027147 




GP9 


YX 


TI 




SYS 


B 




GP9 


UO/ 


002000 


016040 


OOOOOO 


075273 


000003 


OOOOOO 


027147 


002000 




iX 


DX 




SYS 


C 




GP9 


YX 


140/ 


OlbbOO 


OOOOOO 


075273 


000003 


OOOOOO 


027147 


002000 


016300 




Dy 




SYS 


C 




GP9 


YX 


DX 


IbO/ 


000000 


075273 


000003 


OOOOOO 


027147 


002000 


016350 


OOOOOO 






SYS 


C 




GP9 


YX 


UY 




200/ 


075273 


000004 


OOOOOO 


027147 


002000 


070560 


OOOOOO 


075273 




Si(5 


U 




GP9 


YX 


RF 




SYS 


220/ 


000003 


OOOOOO 


0271'»7 


002000 


071070 


OOOOOO 


075273 


000003 




c 




GP9 


YX 


RK 




SYS 


C 


240/ 


000000 


027147 


002000 


015340 


OOOOOO 


075273 


000004 


OOOOOO 






GP9 


YX 


DL 




SYS 


U 




2bO/ 


027147 


002000 


015410 


OOOOOO 


075273 


000005 


OOOOOO 


027147 




GP9 


YX 


DM 




SYS 


K 




GP9 


300/ 


002000 


015770 


OOOOOO 


075273 


000003 


OOOOOO 


027147 


002000 




YX 


US 




SYS 


C 




GP9 


YX 


320/ 


014640 


OOOOOO 


075273 


000005 


OOOOOO 


027147 


002000 


04D600 




DD 




SYS 


E 




GP9 


YX 


LP 


340/ 


000000 


075273 


000002 


OOOOOO 


027147 


002000 


046770 


OOOOOO 






SYS 


B 




GP9 


YX 


LS 




360/ 


075273 


000002 


OOOOOO 


027147 


002000 


012620 


OOOOOO 


075273 




Sib 


B 




GP9 


YX 


CR 




SYS 


400/ 


000003 


OOOOOO 


027147 


002000 


052070 


OOOOOO 


075273 


000011 




C 




GP9 


YX 


MS 




SYS 


1 


420/ 


000000 


027547 


002000 


052150 


014400 


075273 


000003 


OOOOOO 






GV.0 


YX 


MTH 


U 


SYS 


c 




440/ 


027147 


002000 


015173 


052177 


012445 


000011 


OOOOOO 


027547 




Gf9 


YX 


DIS 


MTl 


COM 


1 




GrtO 


460/ 


002000 


051520 


014400 


075273 


000004 


OOOOOO 


027147 


002000 




KX 


MM« 


D 


SYS 







GP9 


YX 


bOO/ 


015173 


052200 


012445 


000010 


OOOOOO 


027b'»I 


002000 


052100 




UlS 


MT2 


COM 


H 




GrtU 


YX 


«Sh 


b20/ 


014400 


075273 


000004 


OOOOOO 


027147 


002000 


054540 


OOOOOO 




U 


SYS 


U 




GP9 


YX 


hU 




540/ 


075273 


000002 


OOOOOO 


027147 


002000 


062170 


OOOOOO 


075273 




SYS 


B 




GP9 


YX 


PC 




SiS 


560/ 


000002 


OOOOOO 


027147 


002000 


062240 


OOOOOO 


075273 


000003 




a 




GP9 


YX 


PL) 




SYS 


C 


600/ 


000000 


027147 


002000 


012740 


OOOOOO 


075273 


000005 


OOOOOO 






GP9 


YX 


CT 




SYS 


E 




620/ 


027147 


002000 


006250 


OOOOOO 


075273 


000007 


OOOOOO 


027147 




GP9 


YX 


BA 




SYS 


G 




GPS 
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640/ 002000 016130 000000 073376 000051 000000 027147 O02O0O 

yx DUP SAV AA GP9 iX 

660/ 023752 050574 073376 000023 OOOOOO 027147 002000 070533 

FOR MAT SAV S GP9 YA HtS 

700/ 060223 073376 000017 OOOOOO 027147 002000 015172 OOOOOO 

OKC SAV GP9 YX DIR 

720/ 073376 000021 OOOOOO 027147 002000 075273 050553 074324 

SAV Q GP9 YX SYS MAC SML 

740/ 000052 OOOOOO 027147 002000 017751 076400 07337b 000023 

AB GP9 YX EDI T SAV S 

760/ OOOOOO 027147 002000 042614 OOOOOO 073376 000073 OOOOOO 
GP9 YX KE:0 SAV AS 
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The E (Examine) command prints in octal the contents of an address on. the 
console terminal. 



; CsPj} address [-address] 



In the command syntax illustrated above, address represents an octal ad- 
dress that, when added to the relocation base value from the Base command, 
provides the actual address that the system examines. This command per- 
mits you to open specific locations in memory and inspect their contents. It is 
most frequently used after a GET command to examine locations in a 
program. 

The Examine command accepts both word and byte addresses, but it alv^ays 
executes the command as though you specified a word address. (If you spec- 
ify an odd address, the system decreases it by one.) 

If you specify more than one address (in the form addressl-address2) , the 
sys- tern prints the contents of addressl through address2, inclusive. The 
second address (address2) must always be greater than the first address. If 
you do not specify an address, the system prints the contents of relative 
location 0. 

Note that you cannot examine addresses outside the background. 

The following example prints the contents of location 1000, assuming the 
relocation base is 0. 

.E 1000 
:l. 2740:1. 

The next command sets the relocation base to 1000. 

,B :i.ooo 

The following command prints the contents of locations 2000 (offset of 1000 
from last B command) through 2005. 

,E :l. 00:1. •■■:(. 005 

:l.2740:l. 007A24 :l.27400 
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The EDIT command invokes the text editor. 



EDIT 


~ r /KED 
;K52 
I /TECOJ 




r- f /CREATE 
/INSPECT 
[ /OUTPUT:tllespec |/ALLOCATE:slze| J 


( SP ) fllespec |/ALL0CATE:8lzel 



The text editor, EDIT, is a program that creates or modifies ASCII files for 
use as input to programs such as the MACRO assembler or the FORTRAN 
corapiler. The editor reads ASCII files from any input device, makes speci- 
fied changes, and writes the file on an output device. It also allows efficient 
use of VTll or VS60 display hardware, if this is part of the system con- 
figuration (except in multi-terminal systems). 

You can also use the Keypad Editor (KED for VTIOO terminals, K52 for 
VT52 terminals) as an alternative to EDIT. The Keypad Editor is restricted 
to the VTIOO and VT52 terminals, however. You can invoke the Keypad 
Editor with the /KED or /K52 options described below. For more information 
on the Keypad Editor, see the; PDP-11 Keypad Editor Usefs Guide. 

NOTE 

You can use the SET EDIT command to set a default editor 
(EDIT, KED, or K52) so that when you issue the EDIT com- 
mand, you invoke that editor. The system defaults to the 
EDIT editor each time you bootstrap, however. For more 
details, see the SET EDIT command description. 

EDIT considers a file to be divided into logical units called pages. A page of 
text is generally 50-60 lines long (delimited by form feed characters) and 
corresponds approximately to a physical page of a program listing. EDIT 
reads one page of text at a time from the input file into its internal buffers 
where the page becomes available for editing. You can then use editing com- 
mands to: 

• Locate text to be changed 

• Execute and verify the changes 

• List an edited page on the console terminal 

• Output a page of text to the output file 

In the command syntax illustrated above, filespec represents the file you 
wish to edit. You can enter the EDIT command on one line, or you can rely 
on the system to prompt you for information. If you do not supply a file speci- 
fication for the file to edit, the system prompts i^iZe?. If you do not specify any 
option with the EDIT command, the text editor performs the edit backup 
operation. To do this, it changes the name of the original file, giving it a file 



Keyboard Commands 4-79 



EDIT 

type of .BAK when you finish making your editing changes. The actual file 
renaming occurs when you successfully exit from the editor. 

When you want to edit an existing file, the editor does not perform any I/O 
operation as a result of your command. You must issue the R command to 
the editor to read the first page of text and make it available for you to work 
on. The following example invokes EDIT, opens an existing file, and reads 
the first page of text: 

.EDIT myf:i:u;;:. tXT 

When you issue an EDIT command, the system invokes the text editor. (l!'ou 
can use the SET EDIT command to set the default editor. If you do not use 
the SET EDIT command, the system assumes EDIT.SAV each time you 
issue the EDIT command. See the SET EDIT command for more informa- 
tion.) It is possible to receive an error or warning message as a result of the 
EDIT command. If, for example, the file you need to edit with EDIT does not 
exist on device DK:, the editor issues an error message and remains in con- 
trol. For example: 

, E 11 1 r / ;i: N s f :■ i:- c; r' i;- x a h i-' 3 . r x i' 

? E D :i: T - 1" ■■• F :i. I e 1 1 o t f o u 1 1 d 

When a situation like this occurs, you can either issue another command 
directly to the text editor or enter CTRL/C followed by two ESCAPES to 
return control to the monitor. 

NOTE 

To perform any edit operations on a protected file, you must 
disable the file's protected status (see the RENAME com- 
mand description). 

The following sections describe the options you can use with the EDIT com- 
mand. A complete description of EDIT is contained in Chapter 5. 

/ALLOCATE:size Use this option with /OUTPUT or after the file specifi- 
cation to reserve space on the device for the output file. The argument size 
represents the number of blocks of space to allocate. The meaningful ra:rige 
for this value is from 1 to 32767. A value of -1 is a special case that creates 
the largest file possible on the device. 

/CREATE Use this option to build a new file. With EDIT you can also cre- 
ate a new file while you are working with the text editor by using the EDIT 
Write (EW) command, described in Chapter 5. The following example cre- 
ates a file called NEWFIL.TXT on device DK:, inserts one line of text, and 
then closes the file. 

. EDiT/cREATi;;: newf:u...txt 

*ITHIS IS A NEW FILE. 
*EX*$ 
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To create a file with /KED oir /K52, see the PDP-11 Keypad Editor User's 
Guide. 

/EXECUTE:filespec Use this option with /TECO to execute the TECO 
commands contained in the file you specify with /EXECUTE. 

/INSPECT Use this option to open a file for reading. This option does not 
create any new output files. You can also open a file for inspection while you 
are working with the EDIT by using the Edit Read (ER) command, which is 
explained in Chapter 5. 

The following command opens an existing file for inspection, lists its con- 
tents, and then exits. 

. Era:T/INBr'E."CT NEWFIL . TXT 

«/L** 

THIS IS A NEW FTLE. 

*'■■(:;** 

/KB]D This option invokes the Keypad Editor (KED). For more informa- 
tion on the Keypad Editor, see the PDP-11 Keypad Editor User's Guide. Use 
/KED only if you are using a VTIOO terminal. 

/K5i2 This option invokes the Keypad Editor. Use /K52 only if you are 
using a VT52 terminal. For more information on the Keypad Editor, see the 
PDP-11 Keypad Editor User's Guide. 

/OUTPUTrfilespec This option directs the text you edit to the file you 
specify, leaving the input file unchanged. You can also write text to an out- 
put file while you are working with EDIT by using the Edit Write (EW) com- 
mand, explained in Chapter 5. The following command reads file 
ORIG.TXT, and writes the edited text to file CHANGE.TXT. 

, EDIT/OUTPUT ; CHANGE , TXT OR IG , TXT 
* 

/TECO This option invokes the TECO editor. (TECO is not supported by 
DIGITAL. It is distributed on the RT-11 kit for the convenience of those cus- 
tomers who normally order TECO from the DECUS Program Library) For 
more information on TECO see the PDP-11 TECO User's Guide. 



Keyboard Commands 4-81 



EXECUTE 



The EXECUTE command invokes one or more language processois to 
assemble or compile the files you specify. It also links object modules and 
initiates execution of the resultant program. 



/EXECUTE (ifilespecl [/ALL0CATE:slZ9l 
/LIST [:fllespecl |/ALLOCATE:sizel 
/MAP tfllespsc] (/ALL0CATE:sl2el[/WIDE] 
/OBJECT [:fllespec| (/ALLOCATElsIze) 

/BOTTOM:n 
/DEBUG [:filespec] 
/LINKLIBRARY l:fMespeol 
/[N0| RUN 



/DIBOL 

/ALPHABETIZE 

/CROSSREFERENCE 

/(NO) LINENUM BERS 

/ONOEBUG 

/[NOl WARNINGS 
/FORTRAN 

/CODE:type 

/DIAGNOSE 

/EXTEND 

/HEADER 

/I4 

/[N0| LINENUMBERS 

/ONDEBUG 

/[NO] OPTIMIZE [:typel 

/RECORD:length 

/SHOW [lvalue] 

/STATISTICS 

/[NO] SWAP 

/UNITS:n 

/[NO] VECTORS 

/WARNINGS 
/MACRO 



/CROSSREFERENCE [:type[ 
/DISABLEivalue [. . :value| 
/ENABLE:value [. . .lvalue] 
_/[NO]SH0W:value 



:type]l 



( SP ) filespec r/LIBRARYl 
[/PASS:1 J 



In the command line shown above, filespecs represents one or more files to be 
included in the assembly. The default file tjrpes for the output files are ,LST 
for listing files, .MAP for load map files, .OBJ for object files, and .SAV for 
memory image files. The defaults for input files depend on the language 
processor involved. These defaults include .MAC for MACRO files, .FOR for 
FORTRAN files, and .DBL for DIBOL files. 

To compile (or assemble) multiple source files into a single object file, sepa- 
rate the files by plus ( + ) signs in the command line. Unless you specify oth- 
erwise, the system creates an object file with the same name as the first 
input file and gives it an .OBJ file type. 

To compile multiple files in independent compilations, separate the files by 
commas (,) in the command line. This generates a corresponding object file 
for each set of input files. The system then links together all the object files 
and creates a single executable file. You can combine up to six files for a 
compilation producing a single object file. You can specify the entire EIXE- 
CUTE command as one line, or you can rely on the system to prompt you for 
information. The EXECUTE command prompt is Files?. 
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There are several ways to eistablish which language processor the EXE- 
CUTE command invokes: 

1. Specify a language-name option, such as /MACRO, to invoke the 
MACRO assembler. 

2. Omit the language-name option and explicitly specify the file type for 
the source files. The EXECUTE command then invokes the language 
processor that corresponds to that file type. Specifying the file 
SOURCE.MAC, for example, invokes the MACRO assembler. 

3. Let the system choose a file type of .MAC, .DBL, or .FOR for the source 
file you name. The handler for the device you specify must be loaded. If 
you specify DX1:A, and the DX handler is loaded, the system searches 
for source files A.MAC and A.DBL, in that order. If it finds one of these 
files, the system invokes the corresponding language processor. If it can- 
not find one of these files, or if the device handler associated with the 
input file is not resident, the system assumes a file type of .FOR and 
invokes the FORTRAN compiler. 

If the language processor selected as a result of this procedure described 
above is not on the system device (SY:), the system issues an error 
message. 

Language options are position-dependent. That is, they have different 
meanings depending on where you place them in the command line. Options 
that qualify a command name apply across the entire command string. 
Options that follow a file specification apply only to the file (or group of files 
separated by plus signs) that they follow in the command string. 

The following sections describe the options you can use with the EXECUTE 
command. 

/ALLOCATE:size Use this option with /EXECUTE, /LIST, /MAP, or 
/OBJECT to reserve space on the device for the output file. The argument 
size represents the number of blocks of space to allocate. The meaningful 
range for this value is from 1 to 32767. A value of -1 is a special case that 
creates the largest file possible on the device, 

/ALPHABETIZE Use this option with /DIBOL to alphabetize the entries 
in the symbol table listing. This is useful for program maintenance and 
debugging. 

/BOTTOM:n Use this option to specify the lowest address to be used by 
the relocatable code in the load module. The argument n represents a six- 
digit, unsigned, even octal number. If you do not use this option, the system 
positions the load module so that the lowest address is location 1000 (octal). 
This option is invalid for foreground links. 

/CODErtype Use this option with /FORTRAN to produce object code that 
is designed for a particular hardware configuration. The argument type rep- 
resents a three-letter abbreviation for the type of code to be produced. The 
valid values are: EAE, EIS, FIS, and THR. See the RT-lllRSTSIE FOR- 
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TRAN IV User's Guide for a complete description of the types of code and 
their function. 

/CROSSREFERENCE[:type[...:type]] Use this option with /MACRO or 
/DIBOL to generate a symbol cross-reference section in the listing. This 
information is useful for program maintenance and debugging. Note t;hat 
the system does not generate a listing by default. You must also specify 
/LIST in the command line to get a cross-reference listing. 

With MACRO this option takes an optional argument. The argument type 
represents a one-character code that indicates which sections of the cross- 
reference listing the assembler should include. Table 4-10 summarizes the 
valid arguments and their meaning. 

/DEBUG[:filespec] Use this option to link ODT (on-line debugging tech- 
nique, described in Chapter 21) with your program to help you debug it. If 
you supply the name of another debugging program, the system links the 
debugger you specify with your program. The debugger is always linked low 
in memory relative to your program. 

/DIAGNOSE Use this option with /FORTRAN to help analyze an internal 
compiler error. /DIAGNOSE expands the crash dump information to include 
internal compiler tables and buffers. Submit the diagnostic printout to DIG- 
ITAL with a software performance report (SPR) form. The information in 
the listing can help DIGITAL programmers locate the compiler error and 
correct it. 

/DIBOL This option invokes the DIBOL language processor to compile the 
associated files. 

/DISABLE:value[...:value] Use this option with /MACRO to specify a 
.DSABL directive. Table 4-11 summarizes the arguments and their mean- 
ing. See the PDP-11 MACRO Language Reference Manual for a description 
of the directive and a list of all legal values. 

/ENABLE:value[...:value] Use this option with /MACRO to specify an 
.ENABL directive. Table 4-11 summarizes the arguments and their mean- 
ing. See the PDP-11 MACRO Language Reference Manual for a description 
of the directive and a list of all legal values. 

/EXECUTE[:filespec] Use this option to specify a file name or device for 
the executable file. Because the EXECUTE command creates executable 
files by default, the following two commands have the same meaning: 

. EXECUTi::: myf^'ROG 

. e: X E c u T E / E X li;: c i.j T i: m y r-' i-< o g 

Both commands link MYPROG.OBJ and produce MYPROG.SAV as a 
result. The /EXECUTE option has different meanings when it follows the 
command and when it follows the file specification. The following command 
creates an executable file called PROGl.SAV on device RKl:. 

, e: X E c u r i;;: / e x e c u t i:;: j r k :i. ; f r o g :i. » p r o g 2 
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The next command creates an executable file called MYPROG.SAV on 
device DK:. 

> E X E C I.) r E R r H 1 1. R I N 2 . M Y P R G/EX E C U T E 

/EXTEND Use this option with /FORTRAN to change the right margin 
for source input lines from column 72 to column 80. 

/FORTRAN This option invokes the FORTRAN language processor to 
compile the associated files. 

/HEADER Use this option with /FORTRAN to include in the printout a 
list of options currently in effect. 

/I4 Use this option with /FORTRAN to allocate two words for the default 
integer data type (FORTRA^T uses only one-word integers) so that it takes 
the same physical space as real variables. 

/LIBRARY Use this option with /MACRO to identify the file the option 
qualifies as a macro library file. Use it only after a library file specification 
in the command line. The MACRO assembler looks first to the library asso- 
ciated with the most recent /LIBRARY option to satisfy references (made 
with the .MCALL directive) from MACRO programs. It then looks to any 
libraries you specified earlier in the command line, and it looks last to 
SYSMAC.SML. 

In the example below, the two files A.FOR and B.FOR are compiled to- 
gether, producing B.OBJ and B.LST. The MACRO assembler assembles 
C.MAC, satisfying .MCALL references from MYLIB.MAC and SYS- 
MAC.SML. It produces C.OBJ and C.LST. The system then links B.OBJ and 
C.OBJ together, resolving undefined references from SYSLIB.OBJ, and pro- 
duces the executable file B.SAV. Finally, the system loads and executes 
B.SAV. 

. i~: X i:;: c; u 1 1;- mb/l :i: s r / o b j e c r v m y i ... :i: b / 1... x b r a r v i c . m a c / 1... :i: s r / o b j e c r 

/LINENUMBERS Use this option with /DIBOL or /FORTRAN to include 
internal sequence numbers in the executable program. These are especially 
useful in debugging programs. This is the default operation. 

/NOLINENUMBERS Use 1:his option with /DIBOL or /FORTRAN to sup- 
press the generation of internal sequence numbers in the executable pro- 
gram. This produces a smaller program and optimizes execution speed. Use 
this option to compile only those programs that are already debugged; other- 
wise the line numbers in DIBOL or FORTRAN error messages are difficult 
to interpret. 

/LINKLIBRARYrfilespec Use this option to include the library file name 
you specify as an object module library during the linking operation. Repeat 
the option if you need to specify more than one library file. 

/LIST[:filespec] You must specify this option to produce a compilation or 
assembly listing. The /LIST option has different meanings depending on 
wh<jre you put it in the command line. 
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If you specify /LIST without filespec in the list of options that immediat;ely 
follows the command name, the system generates a listing that prints on the 
line printer. If you follow /LIST with a device name, the system creates a 
listing file on that device. If the device is a file-structured device, the system 
stores the listing file on that device, assigning it the same name as the input 
file with a .LST file type. The following command produces a listing on the 
terminal: 

. EXECUTE /I... :i: ST trr a. for 

The next command creates a listing file called A.LST on RK3:. 

. i;;: x i;:: c u \ £ / 1... :i: s t J R k 3 ; a . m a c; 

If the /LIST option contains a name and file type to override the default of 
.LST, the system generates a listing file with that name. The following com- 
mand, for example, compiles A.FOR and B.FOR together, producing files 
A.OBJ and FILEl.OUT on device DK:. It then links A.OBJ (using SYS- 
LIB.OBJ as needed) and produces A.SAV. 

, t;: X i;;: (:; u T e: / N R u N / 1-- (3 R T r? A N / 1... .1: ;;; r : I" 1 1.., i;;: :u u r a t- b 

Another way to specify /LIST is to type it after the file specification to which 
it applies. To produce a listing file with the same name as a particular iniput 
file, you can use a command similar to this one: 

. i::: X 1;;: c; u r 1:;: / D :i: B 1... a i b / 1... 1: s t s r i< :n 

The command shown above compiles A.DBL and B.DBL together, producing 
files DK:A.OBJ and RK3:B.LST. It then links A.OBJ (using SYSLIB.OBJ as 
needed) and produces DK:A.SAV. If you specify a file name on a /LIST 
option following a file specification in the command line, it has the same 
meaning as when it follows the command. The following two commands 
have the same results: 

, i;r X E c; u r 1:;: / M A c; R a / 1 ... :i; s i ; b 
, 1;;: X k: c u t 1;;: / M A c; r? / 1.. I s T i B a 

Remember that file options apply only to the file (or group of files that are 
separated by plus signs) that they follow in the command string. For 
example: 

. E X E C U r E / N 1'^ I.) N A . H A C / 1... :i: S T !. B . F R 

This command compiles A.MAC, producing A.OBJ and A.LST. It also com- 
piles B.FOR, producing B.OBJ. However, it does not produce any listing file 
for the compilation of B.FOR. Finally, the system links A.OBJ and B.OBJ 
together, producing A.SAV. 

/MACRO This option invokes the MACRO assembler to assemble associ- 
ated files. 

/MAP[:fllespec] You must specify this option to produce a load map sifter 
a link operation. The /MAP option has different meanings depending on 
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where you put it in the command line. It follows the same general rules out- 
lined above for /LIST. 

/OB JECT[;fiIespec] Use this option to specify a file name or device for the 
object file. Because the EXECUTE command creates object files by default, 
the following two commands have the same meaning: 

.EXECUTE/FORTRAN A 
.EXECUTE/FORTRAN/OBJECT A 

Both commands compile A. FOR and produce A. OBJ as output. The 
/OBJECT option functions like the /LIST option; it can be either a command 
or a file qualifier. 

As a coihmand option, /OBJECT applies across the entire command string. 
The following command, for example, assembles A.MAC and B.MAC sepa- 
rately, creating object files A. OBJ and B.OBJ on RKl:. 

. EXECUTE/OBJECT J RK 1 : A . MAC , B . MAC 

Use /OBJECT as a file option to create an object file with a specific name or 
destination. The following command compiles A.DBL and B.DBL together, 
creating files B.LST, B.OBJ, and B.SAV. 

, E X 1^ c u ri:;: / D T B 1 a ■{■ b / 1... i: s i / o b j e c; r / e: x e c; u t i;;: 

/ONDEBUG Use this option with /DIBOL to include a symbol table in the 
object file. You can then use a debugging program to find and correct errors 
in the object file. 

Use /ONDEBUG with /FORTRAN to include debug lines (those that have a 
D in column one) in the compilation. You do not, therefore, have to edit the 
file to include these lines in the compilation or to logically remove them. 
You can include messages, flags, and conditional branches to help you trace 
program execution and find an error. 

/OPTIMIZE:type Use this option with /FORTRAN to enable certain 
options that optimize object code for various conditions. The argument type 
represents the three-letter code for the type of optimization to be enabled. 
Table 4-4 summarizes the codes and their meaning. This option is not avail- 
able with version 2.5 of the FORTRAN compiler. 

/NOOPTIMIZErtype Use this option with /FORTRAN to disable certain 
options that optimize object cede for various conditions. The argument type 
represents the three-letter code for the type of optimization to be disabled. 
Table 4-4 summarizes the codes and their meaning. This option is not avail- 
able with version 2.5 of the FORTRAN compiler. 

/PASS:1 Use this option with /MACRO on a prefix macro file to process 
that file only during pass 1 of the assembly. This option is useful when you 
assemble a source program together with a prefix file that contains only 
macro definitions, since these do not need to be redefined in pass 2 of the 
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assembly. The following command assembles a prefix file and a source file 
together, producing files PROGl.OBJ, PROGl.LST, and PROGl.SAV. 

4::xE(:;uTE/NC)RUN/MACRo PREFIX/PASS J :L+PRa(3i. /I... :i:Br/OBJECT/i;-XE(:;uTiii: 

/RECORD:length Use this option with /FORTRAN to override the 
default record length of 132 characters for ASCII sequential formatted input 
and output. The meaningful range for length is from 4 to 4095. 

/RUN Use this option to initiate execution of your program if there are no 
errors in the compilation or the link. This is the default operation. Do not 
use /RUN with any option that requires a response from the terminal. 

/NORUN Use this option to suppress execution of your program. The sys- 
tem performs only the compilation and the link. 

/SHOW[:value] Use this option with /FORTRAN to control FORTfLAN 
listing format. The argument value represents a code that indicates wliich 
listings the compiler is to produce. Table 4-5 summarizes the codes and 
their meaning. ^ 

Use this option with /MACRO to specify any MACRO .LIST directive. Table 
4-12 summarizes the valid arguments and their meaning. The PDP-11 
MACRO Language Reference Manual explains how to use these directives. 

/NOSHOWrvalue Use this option with /MACRO to specify any MACRO 
.NLIST directive. Table 4-12 summarizes the valid arguments and their 
meaning. The PDP-11 MACRO Language Reference Manual explains how 
to use these directives. 

/STATISTICS Use this option with /FORTRAN to include compilation 
statistics, such as amount of memory used, amount of time elapsed, and 
length of the symbol table. 

/SWAP Use this option with /FORTRAN to permit the USR (user service 
routine) to swap over the FORTRAN program in memory. This is the default 
operation. 

/NOSWAP Use this option with FORTRAN to keep the USR resident dur- 
ing execution of a FORTRAN program. This may be necessary if the FOR- 
TRAN program uses some of the RT-11 System subroutine library calls (see 
the RT-11 Programmer's Reference Manual). If the program frequently 
updates or creates a large number of different files, making the USR resi- 
dent can improve program execution. However, the cost for making the USR 
resident is 2K words of memory. 

/UNITS :n Use this option with /FORTRAN to override the default number 
of logical units (6) to be open at one time. The maximum value you can spec- 
ify for n is 16. 

/VECTORS This option directs FORTRAN to use tables to access multi- 
dimensional arrays. This is the default mode of operation. 

/NOVECTORS This option directs FORTRAN to use multiplication oper- 
ations to access multidimensional arrays. 
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AVARNINGS Use this option to include warning messages in DIBOL or 
FORTRAN compiler diagnostic error messages. These messages call certain 
conditions to your attention but do not interfere with the compilation. This 
is the default operation for DIBOL. 

/NOWARNINGS Use this option with /DIBOL to suppress warning mes- 
sages during compilation. These messages are for your information only; 
they do not affect the compilation. This is the default operation for 
FOIRTRAN. 

/WIDE Use this option with /MAP to produce a wide load map listing. Nor- 
mally, the listing is wide enough for three Global Value columns, which is 
suitable for a page with 72 or 80 columns. The /WIDE option produces a list- 
ing that is six Global Value columns wide, or 132 columns. 
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The FORMAT command formats disks and diskettes, and verifies any disk, 
diskette, DECtape, or DECtape II. 



FORMAT 



/PATTERN |:value| 
/[NO] QUERY 
/SINGLEDENSITY 
/VERIFY |:0NLY1 
/WAIT 




In the command syntax described above, device represents the storage vol- 
ume you wish to format and/or verify. Although you can verify any disk or 
DECtape, the formatting process is valid only for the disks and diskettes 
listed below. 

RX01-RX02 
RK05 

RP02-RP03 
RK06-RK07 

When the system formats a volume, it writes headers for each block in the 
volume. The header of a block contains data the device controller must use 
to transfer data to and from that block. Using the FORMAT command to for- 
mat a storage volume makes that volume usable to the RT-11 operating sys- 
tem. Formatting is advisable under the following circumstances: 

• when you receive a new RK05 disk from DIGITAL 

• when you wish to format an RX02 double density diskette to single den- 
sity, and vice versa 

• when you wish to eliminate bad blocks (though formatting does not guar- 
antee the elimination of every bad block, formatting can reduce the 
number of bad blocks) 

When the system verifies a volume, it writes a 16-bit pattern on each block 
in the volume, and then reads each pattern. When the system is unable to 
write and read a pattern, it reports a bad block. The verification process is 
similar to the bad block scan (see INITIALIZE), except that verification is a 
data-destructive process. That is, whereas bad block scanning only reads 
data from each block on a volume, verifying both writes and reads data, 
destroying any data previously existing on the volume. Because the \'^eri- 
fication process reads and writes data, it can be more effective than a bad 
block scan in establishing the validity of data contained in a block. \''eri- 
fying also makes sure that the previous formatting operation was 
successful. 

NOTE 

You can format a diskette (RXOl or RX02) only when you 
have mounted the diskette in a double density diskette 
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drive unit (DY). Unless you use the /SINGLEDENSITY 
option, the system will format both single and double den- 
sity diskettes in double density format. If you attempt to 
format a diskette in a single density drive unit (DX), the 
system will print an eiror message. 

When you format an RK06 or RK07 disk, the system lists the block numbers 
of all the bad blocks in the ma nufacturer's bad block table and in the soft- 
ware bad block table. 

The options you can use with the FORMAT command follow. 

/PATTERN[:value] Use this option with /VERIFY[:ONLY] to specify 
which 16-bit patterns you want the system to use when it verifies the vol- 
ume. The optional argument value represents an octal integer in the range 
to 377 that denotes which of eight patterns you want used. The /P:n option in 
Chapter 18 provides a complete description of the patterns you can specify 
with /PATTERN[: value]. As tjie system uses each pattern, it prints at the 
terminal which pattern it is using. 

The command line that follows verifies an RK05 disk with the 16-bit pat- 
terns denoted by the value 25. 

.format/mer:i:fy/pattern;25 rko; 

RKO J /FORMAT -A re you sure? Y 

? !-• R M A T •••• ;i: - !=■ o r m s 1 1: :i. I "I K! c- o m p 1 e t (o> 

PATTERN #5 

PATTERN #3 

PATTERN #:l. 

? FC) R M A T ■ :i: - V e r :i. f :i. c 3 1 1 o n c o in f- 1. e t e 

If you do not supply a value with /PATTERN, the system uses pattern #8. 

/QUERY Use this option v/hen you want the system to print a con- 
firmation message before it performs formatting or verification. This is the 
default setting. 

/NOQUERY Use this option if you do not want the system to print a con- 
firmation message before it p<;rforms formatting or verification. When you 
use this option in the FORMAT command line, the system prints only the 
pattern numbers it uses if it performs verification and the informational 
messages indicating the formatting or verification is complete. The default 
setting is /QUERY. 

/SINGLEDENSITY Use this option to format an RX02 double density 
diskette in single density format. The following example uses the /SINGLE- 
DENSITY option to format an RX02 in drive unit 1 as a single density 
diskette. 

.F- ormat/s:i;ngi...edensity dyi. : 

i:iYl.!: /FORMAT -Are you sure? Y 
? F' R M A T - :i: ■■•■ F' o nn iii t, t :i. 1 1 <•! c a m p :I e t e 

/VERIFY[:ONLY] Use this option when you want to verify a volume fol- 
lowing formatting. Use the optional argument, :ONLY, when you want the 
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system to only verify a volume. (Note that although you can format only a 
limited variety of storage volumes, you can verify any disk, diskette, DEC- 
tape, or DECtape II.) When you use /VERIFY, the system first formats the 
specified volume, and then writes a bit pattern to each block on the volume. 
Next, the system reads each pattern. After the verification process is com- 
plete, the system prints at the terminal the block number of each bad block 
it found. 

The example that follows uses /VERIFY to format and verify an RK05 disk 
in drive unit 2. 

.FORMAT/VERIFY RK2 J 
RK2;/F0RHAT-Ar(v! M01.1 suri;'? Y 
TFORHAT- 1 ■•Fc) r mat t i ns comp 1 e te 
PATTERN *8 
? f" (1 R M A T •■•• :i: • •■ y e r :i. f :i. <:: s t :i. o 1 'r <:; o m p 1 e t e 

The next example uses /VERIFY:ONLY to only verify an RXOl diskette in 
drive unit 0. 

.FDRMAT/UERIFY ! ONLY DXO J 
DXOJ/yERIFY-Are «ou sure? Y 
PATTERN #8 
'I' F C) R M A T - 1 - y e r :i. f :i. c ii! t :i. o n c: o ivi p 1 e t e 

/WAIT Use this option to pause before formatting begins in order to sub- 
stitute a second volume for the volume you specify in the command line. The 
/WAIT option is useful for single drive systems. After the system accepts 
your command line, it pauses while you exchange volumes. Type a Y fol- 
lowed by a carriage return when you have exchanged volumes and are rciady 
for formatting to begin. When formatting completes, the system pauses 
again while you replace the system volume. Type a Y followed by a carriage 
return after you have remounted the system volume to terminate the for- 
matting operation. 

The following example uses the /WAIT option to format an RK05 disk. 

.FORMAT/WAIT RKO J 

RKOS/FORMAI -Are you sure? Y 

Insert volume wou wish to format. CONTINUE ( Y/N) ?Y 

/ F R M A T ■ ■ :i: •■ I-' o I' m ;rt t :i. n ■;! c o in p I e 1 0? 

r e p :i. a c e o r i !^ i n s 1. v o :i. u me. t • N T' I N U E: ( Y / N ) ? Y 
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The FORTRAN command invokes the FORTRAN IV compiler to compile 
one or more source programs. 



FORTRAN 


/LIST lilllespecl [/ALLOCATErsize] 

/|N01 OBJECT [:fllesp8Cl [/ALLOCATE:slzel 

;CODE:tvpe 
/DIAGNOSE 
/EXTEND 

/HEADER 

/I4 

/[NOl LINENUMBERS 

/ONDEBUG 

/[NOl OPTIMIZE [:typel 

/RECORD:length 

/SHOW [lvalue] 

/STATISTICS 

/[NO] SWAP 

/UNITSin 

/[NO] VECTORS 

/WARNINGS 


( SP } fllespecs 



You can enter the FORTRAN command as one line, or you can rely on the 
system to prompt you for information. The FORTRAN command prompt is 
Files? for the input specification. 

In the command syntax illustrated above, filespecs represents one or more 
files to be included in the compilation. If you omit a file type for an input file, 
the system assumes .FOR. Output default file types are .LST for listing files 
and .OBJ for object files. To compile multiple source files into a single object 
file, separate the files with plus ( + ) signs in the command line. Unless you 
specify otherwise, the system creates an object file with the same name as 
the first input file and gives it an .OBJ file type. To compile multiple files in 
independent compilations, separate the files with commas (,) in the com- 
mand line. This generates a corresponding object file for each set of input 
files. 

Language options are positicm-dependent — that is, they have different 
meanings depending on where you place them in the command line. Options 
that qualify a command name apply across the entire command string. 
Options that follow a file specification apply only to the file (or group of files 
separated by plus signs) that they follow in the command string. 

The RT-lllRSTSIE FORTRAN IV User's Guide contains detailed informa- 
tion about using FORTRAN. The following sections describe the options you 
can use with the FORTRAN command. 

/AL,LOCATE:size Use this option with /LIST or /OBJECT to reserve 
space on a device for the output file. The argument size represents the num- 
ber of blocks of space to allocate. The meaningful range for this value is from 
1 to 32767. A value of-1 is a special case that creates the largest file possible 
on the device. 
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/CODE:type Use this option to produce object code that is designed for a 
particular hardware configuration. The argument type represents a thiee- 
letter abbreviation for the type of code to be produced. The legal values jire: 
EAE, EIS, FIS, and THR. See the RT-lllRSTSIE FORTRAN IV User's 
Cruide for a complete description of the types of code and their function. 

/DIAGNOSE Use this option to help analyze an internal compiler eri-or. 
/DIAGNOSE expands the crash dump information to include internal com- 
piler tables and buffers. Submit the diagnostic printout to DIGITAL with a 
software performance report (SPR) form. The information in the listing can 
help DIGITAL programmers locate the compiler error and correct it. 

/EXTEND Use this option to change the right margin for source input 
lines from column 72 to column 80. 

/HEADER This option includes in the printout a list of options that are 
currently in effect. 

/I4 Use this option to allocate two words for the default integer data type 
(FORTRAN uses one-word integers) so that it takes the same physical space 
as real variables. 

/LINENUMBERS Use this option to include internal sequence numbers 
in the executable program. These are especially useful in debugging a F(!)R- 
TRAN program. They identify the FORTRAN statements that cause run- 
time diagnostic error messages. This is the default operation. 

/NOLINENUMBERS This option suppresses the generation of internal 
sequence numbers in the executable program. This produces a smaller pro- 
gram and optimizes execution speed. Use this option to compile only those 
programs that are already debugged; otherwise the line numbers in FOR- 
TRAN error messages are replaced by question marks and the messages are 
difficult to interpret. 

/LIST[:fiIespec] You must specify this option to produce a FORTRAN 
compilation listing. The /LIST option has different meanings depending on 
where you place it in the command line. 

The /LIST option produces a listing on the line printer when /LIST follows 
the command name. For example, the following command line produces a 
line printer listing after compiling a FORTRAN source file: 

. FORTRAN/LIST MYPROG<Rt-T> 

When the /LIST option follows the file specification, it produces a listing file. 
For example, the following command line produces the listing file 
DK:MYPROG.LST after compiling a FORTRAN source file: 

. FORTRAN MYPROG/L.lST<REr> 

If you specify /LIST without a file specification in the list of options that 
immediately follows the command name, the FORTRAN compiler generiites 
a listing that prints on the line printer. If you follow /LIST with a device 
name, the system creates a listing file on that device. If the device is a file- 
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structured device, the system stores the listing file on that device, assigning 
it the same name as the input file with a .LST file type. The following com- 
mand produces a listing on thie terminal: 

.FORTRAN/LIST 5 TT{ A 

The next command creates a listing file called A. LST on RK3:. 

. FORTRAN/LIST :RK3: A 

If the /LIST option contains a name and file type to override the default of 
.LST, the system generates a listing file with that name. The following com- 
mand, for example, compiles A.FOR and B.FOR together, producing files 
A.OBJ and FILEl.OUT on device DK:. 

. F0RTRAN/L3:sr:F;ti...E;: 1 .OUT a+b 

Another way to specify /LIST is to type it after the file specification to which 
it applies. To produce a listing file with the same name as a particular input 
file, you can use a command similar to this one: 

, FORTRAN A+LVI... I BT : RK3 : 

The above command compiles A.FOR and B.FOR together, producing files 
DK:A.OBJ and RK3:B.LST. If you specify a file name on a /LIST option fol- 
lowing a file specification in the command line, it has the same meaning as 
when it follows the command. The following two commands have the same 
results: 

.FORTRAN A/LIST;B 

.fortran/lj:st:h a 

Both the above commands generate A.OBJ and B.LST as output files. 

Remember that file options apply only to the file (or group of files that are 
separated by plus signs) that they follow in the command string. For 
exiimple: 

.FORTRAN A/L:rSTi.B 

This command compiles A.FOR, producing A.OBJ and A. LST. It also com- 
piles B.FOR, producing B.OBJ. However, it does not produce any listing file 
for the compilation of B.FOR. 

/OBJECT[:filespec] Use this option to specify a file name or device for the 
object file. Because FORTRAN creates object files by default, the following 
two commands have the same; meaning; 

.FORTRAN A 

. FORTRAN/OBJECT A 

Both commands compile A.FOR and produce A.OBJ as output. The 
/OBJECT option functions like the /LIST option; it can be either a command 
or a file qualifier. 
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As a command option, /OBJECT applies across the entire command string. 
The following command, for example, compiles A.FOR and B.FOR sepa- 
rately, creating object files A. OB J and B.OBJ on RKl:. 



.i-ortran/object:rm : AvB 

Use /OBJECT as a file option to create an object file with a specific name or 
destination. The following command compiles A.FOR and B.FOR together, 
creating files B.LST and B.OBJ. 

. FORTRAN A+B/LlSr/OBJECT 

/NOOBJECT Use this option to suppress creation of an object file. As a 
command option, /NOOBJECT suppresses all object files; as a file option, it 
suppresses only the object file produced by compilation of the related input 
files. In this command, for example, the system compiles A.FOR and B.FOR 
together, producing files A. OBJ and B.LST. It also compiles C.FOR and pro- 
duces C.LST, but does not produce C.OBJ. 

.FORTRAN AfH/LISTfC/NOOBJECT/LIST 

/ONDEBUG Use this option to include debug lines (those that have a I) in 
column one) in the compilation. You do not, therefore, have to edit the file to 
include these lines in the compilation or to logically remove them. This 
option is useful in debugging a program. You can include messages, flags, 
and conditional branches to help you trace program execution and find an 
error. 

/OPTIMIZE :type Use this option to enable certain options that optimize 
object code for various conditions. The argument type represents the three- 
letter code for the type of optimization to be enabled. Table 4-4 summarizes 
the codes and their meaning. 

Table 4-4: Optimization Codes 



Code 


Meaning 


BND 


Global register bindings for inline code generation 




CSE 


Common subexpression elimination 




SPD 


Optimization for speed of execution, as opposed to minimal program 


size 


STR 


Strength reduction optimization 





This option is not available with version 2.5 of the FORTRAN compiler. 

/NOOPTIMIZErtype Use this option to disable certain options that opti- 
mize object code for various conditions. The argument type represents the 
three-letter code for the type of optimization to be disabled. Table 4-4 sum- 
marizes the codes and their meaning. This option is not available with ver- 
sion 2 . 5 of the FORTRAN compiler. 

/RECORD:length Use this option to override the default record length of, 
usually 132, characters for ASCII, sequentially formatted input and output. 
The meaningful range for length is from 4 to 4095. 
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/SHOW[:value] Use this option to control FORTRAN listing output. The 
argument value represents a code that indicates which listings the compiler 
is to produce. Table 4-5 sumraarizes the codes and their meaning. You can 
combine options by specifying the sum of their numeric codes. For example: 

/SHOW:? 

or 

/SHOW:ALL 

The two options shown above have the same meaning. If you specify no code, 
the default value is 3, a combination of SRC and MAP. 



Table 4-5: 


FORTRAN Listing Codes 


Code 


Listing Content 





Diagnostics only 


1 or SRC 


Source program and diagnostics 


2 or MAP 


Storage map and diagnostics 


3 


Diagnostics, source program, and storage map 


4 or COD 


Generated code and diagnostics 


7 or ALL 


Diagnostics, source program, storage map, and generated code 



/STATISTICS Use this option to include compilation statistics in the list- 
ing, such as amount of memory used, amount of time elapsed, and length of 
the symbol table. 

/SWAP Use this option to piermit the USR (user service routine) to swap 
over the FORTRAN program in memory. This is the default operation. 

/NOSWAP This option ketjps the USR resident during execution of a 
FORTRAN program. This may be necessary if the FORTRAN program uses 
some of the RT-11 system subroutine library calls (see Chapter 4 of the 
RT-11 Programmer's Reference Manual). If the program frequently updates 
or creates a large number of different files, m.aking the USR resident can 
improve program execution. However, the cost for making the USR resident 
is 2K words of memory. 

/UNITSin Use this option to override the default number of logical units 
(6) to be open at one time. The maximum value you can specify for n is 16. 

/VECTORS This option directs FORTRAN to use tables to access multi- 
dimensional arrays. This is the default mode of operation. 

/NO VECTORS This option directs FORTRAN to use multiplication oper- 
ations to access multidimensional arrays. 

/WARNINGS Use this opti(m to include warning messages in FORTRAN 
compiler diagnostic error messages. These messages call certain conditions 
to your attention, but do not interfere with the compilation. A warning mes- 
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sage prints, for example, if you change an index within a DO loop, or ilf you 
specify a variable name longer than six characters. 

/NOWARNINGS Use this option to exclude warning messages in FOR- 
TRAN compiler diagnostic error messages. This is the default setting. 
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The FRUN command initiates foreground jobs. The default file type is .REL. 



FRUN ( SP ) (ilespec 



/BUFFERrn 
/PAUSE 
/TERMINAUn 
/NAME:jobname_ 



In the command syntax illustrated above, filespec represents the program to 
execute. Because this command runs a foreground job, it is valid for the FB 
and XM monitors only. 

If a foreground job is active when you issue the FRUN command, an error 
message prints on the terminal. You can run only one foreground job at a 
time. If a terminated foreground job is occupying memory, the system re- 
claims that region for your program. Then, if the system finds your program 
and if your program fits in the available memory, execution begins. 

The following sections describe the options you can use with FRUN. Note that 
the option must follow the file specification in the command line. 

Note that you can use the FRUN command to run a virtual foreground job, 
and that you can use FRUN to run a virtual .SAV file in the foreground under 
the XM monitor. 

/BUFFER:n Use this option to reserve more space in memory than the 
actual program size. The argument n represents, in octal, the number of 
words of memory to allocate. You must use this option to execute a FOR- 
TRAN foreground job. If you use /BUFFER for a virtual job linked with the A^ 
option (or /XM), the system ignores /BUFFER because it has already pro- 
vided a buffer in extended memory. 

The following formula determines the space needed to run a FORTRAN pro- 
gram as a foreground job. 

n = [l/2[504 + (33*N) + (R-136) + A*512]] 

where: 

A represents the maximum number of files open at any one time. 
Each file opened as double buffered should be counted as two files. 

N represents the maximuih number (decimal) of simultaneously open 
channels (logical unit numbers). This value is specified when the 
compiler is built, and can be overridden with the /UNITS option 
during main program compilation; the default value is 6. Make 
sure you use a decimal point with this number. 

R represents the maximum formatted sequential record length. This 
value is specified when the compiler is built and can be overridden 
with the /RECORD option during main program compilation; the 
default value is 136. 
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This formula must be modified for certain System Subroutine Library (SYS- 
LIB) functions. 

The IQSET function requires the formula to include additional space for 
queue elements (qcount) as follows: 

n = [l/2[504 + (33*N) + (R-136) + A*512]] + [10*qcountl 

The ICDFN function requires the formula to include additional space for the 
integer number of channels (num) as follows: 

n = [l/2[504 + (33*N) + (R-136) + A*512]] + [6*num] 

The INTSET function requires the formula to include additional space for the 
number of INTSET calls issued in the program as follows: 

n = [l/2[504 + (33*N) + (R-136) + A*512]] + [25*INTSET] 

Any functions, including INTSET, that invoke completion routines must in- 
clude 64(decimal) words plus the number of words needed to allocate the 
second record buffer (default is 68(decimal) words). The length of the record 
buffer is controlled by the /RECORD option to the FORTRAN compiler. If 
the /RECORD option is not used, the allocation in the formula must be 
136(decimal) bytes, or the length that was set at FORTRAN installation time. 
This modifies the formula as follows: 

n = [l/2[504 + (33*N) + (R-136) + A*512]] + [64 + R/2] 

If the /BUFFER option does not allocate enough space in the foreground on 
the initial call to a completion routine, the following message appears: 

VERF^ 0» NON -FORTRAN error call 

This message also appears if there is not enough free memory for the back- 
ground job or if a completion routine in the single-job monitor is activated 
during another completion routine. In the latter case, the job aborts; you 
should use the FB monitor to run multiple active completion routines. 

/PAUSE Use this option to help you debug a program. When you type the 
carriage return at the end of the command string, the system prints the load 
address of your program and waits. You can examine or modify the program 
(by using ODT, described in Chapter 21) before starting execution. You must 
use the RESUME command to start the foreground job. The following com- 
mand loads the program DEMOSP.REL, prints the load address, and waits 
for a RESUME command to begin execution. 

.FRUN DEMOSP/P 
Loaded at 127276 
.RESUME 

/TERMINAL:n This option is meaningful only in a multi-terminal system. 
Use it to assign a terminal to interact with the foreground job. The argument 
n represents a terminal logical unit number. If you do not use this option, the 
foreground job shares the console terminal with the background job. By as- 
signing a different terminal to interact with the foreground job, you eliminate 
the need for the foreground and background jobs to share the console termi- 
nal. Note that the original console terminal still interacts with the back- 
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ground job and with the keyboard monitor, unless you use the SET TT: CON- 
SOL command to change this. 

/NAMErname Use this option to assign a logical name to the foreground 
job. This option is valid only on a monitor that has system job support, a 
special feature enabled by the system generation process. 
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The GET command loads a memory image file into memory. 



GET ( SP ) lllespec 



In the command syntax shown above, filespec represents the memory image 
file to be loaded. The default file type is .SAV-. Note that magtape and cas- 
sette are not block-replaceable devices and therefore are not permitted vdth 
the GET command. Use the GET command for a background job only. You 
cannot use GET on a virtual program that executes under the XM monitor. 
The GET command is useful when you need to modify or debug a program. 
You can use GET with the Base, Deposit, Examine, and START commands 
to test changes. Use the SAVE command to make these changes permanent. 
You can combine programs by issuing multiple GET commands, as the fol- 
lowing example shows. This example loads a program, DEMOSP.SAV, loads 
ODT.SAV (on-line debugging technique, described in Chapter 21), and 
starts the program using the address of ODT's entry point. 



.GET 


DEMOSP 


.GET 


OUT 


.STAFJT 


ODT 
* 


yoi.04 



If more than one program requires the same locations in memory, the pro- 
gram you load later overlays the previous program. Note that you cannot 
use GET to load overlay segments of a program; it can load only the root. If 
the file you need to load resides on a device other than the system device, the 
system automatically loads that device handler into memory when you issue 
the GET command. This prevents problems that occur if you use the START 
command and your program is overlaid. 
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The GT command enables or disables the VTll or VS60 display hardware. 




When you issue the GT OFF command, you disable the display hardware. 
Th6! printing console terminal then becomes the device that prints output 
from the system. 

When you issue the GT ON command, the display screen replaces the print- 
ing console terminal. The display screen offers some advantages over the 
printing terminal: (1) it is quieter than a printing terminal, (2) it is faster 
than a printing terminal, (3) it does not require a supply of paper, and (4) it 
is the device for which EDIT's immediate mode is intended. The display 
screen can speed up the editing process (see Chapter 5 for information on 
how to use the text editor). You can use CTRL/A, CTRL/S, CTRL/E, and 
CTRL/Q to control scrolling. These commands are explained in Chapter 3. 

Note that RT-11 does not perinit you to use display hardware (with GT ON) 
if you have multi-terminal sujjport (enabled by a user-generated monitor) or 
if you have an 8K configuration. You cannot use GT ON or GT OFF when a 
foreground or system job is a(;tive; this causes the system to print an error 
message. Issue the GT ON command before you begin execution of the fore- 
ground job. ODT (on-line debugging technique, described in Chapter 21) is 
the only system program that cannot use the display screen. Its output 
always appears on the console terminal. You can use VDT, a variant of 
ODT, because it can interact with the display hardware. 

NOTE 

If an indirect command file issues a GT ON command, part 
of the command may echo on the terminal and the rest may 
echo on the graphics screen. Also, if you type the GT ON 
command, followed by CTRL/E, the initial line on the ter- 
minal overprints when you type GT OFF. 

The following options control the number of lines that appear on the screen 
and position the first line vertically. 

/L:n Use this option to change the number of lines of text that display on 
the screen. Table 4-6 shows the valid range for the argument n in decimal. 
If you do not use this option the system determines the screen size and auto- 
matically assigns the largest valid value. 
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/T:n Use this option to change the top position of the scroll display. Taible 
4-6 shows the valid range for the argument n in decimal. If you do not use 
this option, the system determines the screen size and automatically assigns 
the largest valid value. 



Table 4-6: 


Display Screen Values 


Screen Size 


Lines 


Top Position 


12-inch 
17-inch 


1-31 
1^0 


1-744 

1-1000 (or larger) 
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The HELP command lists information related to RT-11 commands to help 
you remember command syntax, options, and so on, when you are at the 
console. 



rj/TERMlNALn dE) '°Pi<= ( SP ) siibtopicMtem] 
Ll/PRINTER J J [ [ ,op,ion 



In the command syntax showrii above, topic represents a subject about which 
you need information. In the help file supplied with RT-11, the topics are 
the keyboard monitor commands. The subtopic represents a category within 
a topic. In the RT-11 help file, the subtopics are SYNTAX, SEMANTICS, 
OPTIONS, and EXAMPLES. The item represents one member of the sub- 
topic group. You can specify more than one item in the command line if you 
separate the items by colons (:). If you type HELP followed by a carriage 
return, the system lists information on the HELP command. 

The HELP command permits you to access the HELP text file. The help file 
distributed with RT-11 contains information about the keyboard monitor 
commands and how to use them. However, the concept of the help file is a 
general one. That is, you can create your own help file to supply quick refer- 
ence material on any subject. For information on how to change the HELP 
text file, see the RT-11 Installation and System Generation Guide. There are 
only two options you can use with the HELP command. They are /PRINTER 
and /TERMINAL. 

/PRINTER Use this option to list information on the line printer. 

/TERMINAL This option lists information on the console terminal. This 
is the default operation. 

The following examples all make use of the standard RT-11 help file. 

The following command lists all the topics for which assistance is available. 

.HELP Xt 

A PL Invokes thto? APL :LariK!ua<;,ie interpretosr 

ASSIGN Associates 3 :i.osS:i.c3:i. device nsme with a phasic si device 

B Sets B relocation base 
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The next command lists all the information about the DATE command. 

.HELP HATE 

HATE Sets or d:i. spilaas the current si^ratejm date 

SYNTAX 

DATEr: dd-itiiviiTi-H«;] 

SEMANTICS 

A :i. 1 n i.j m e r :i. c v a I u e <:; a r e d e c :i. m <ii I v iti iri in i s t h e f :l t' s t three 
characters of the name of the month 

OPTIONS 

None 

EXAMPLES 

DATE :L2-MAY--79 

The next command lists all the options that are valid with the DIRECTORY 
command. 

.HELP DIRECTORY OPTIONS 

OPTIONS 

ALLOCATE J si. ire 

Use with /OUTPUT to reserve space for the outr-ut listing 

file 
ALPHABETIZE 

Sorts the directory in alphabetical order bw file name 

and type 



The next command lists information about the /BRIEF option for the 
DIRECTORY command. 

.HELP DIRECTORY OPTIONS t BRIEF 

BRIEF 

Lists only file names and file types of files? same as 
/FAST 

The following command lists information about the DIRECTORY command 
options that begin with B. 

.HELP D I RECTOR Y/B 
BADBLOCKS 

Scans the device for bad blocks and types their octal 

number 
BEFORECdate:] 

Lusts the files created before the date you specify 
BEGIN 

Lists the di recto rye startinsl with the file you specify 

BLOCKS 

Lists the starting block numbers of the files 
BRIEF 

Lists only file names and file types of files? same as 

/FAST 
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Use the INITIALIZE command to clear and initialize a device directory. 



/DOS [/INOIQUERY] 
/INTERCHANGE (/[NOlQUERYl 

/FILE:filespec 

/[NO] QUERY 

/VOLUMEID[:ONLY] 

/SEGMENTS:n 

/REPLACE (:RETAIN1 

/BADBLOCKS 

/WAIT 

/RESTORE 




In the command syntax illustrated above, device represents the volume you 
need to initialize. The initialize operation must always be the first operation 
you perform on a new volume after you receive it, formatted, from the manu- 
facturer. If the volume is not formatted, use the FORMAT command (see the 
FORMAT command description) to format the volume. After you use the 
INITIALIZE command, there are no files in the directory. If you use the 
INITIALIZE command with no options, the system simply initializes the 
device directory. You can enter the INITIALIZE command as one line, or you 
can rely on the system to prompt you for the name of the device with Device?. 
The following sections describe the options you can use with INITIALIZE and 
give some examples of their use. 

The default number of directory segments for RT-11 directory structured 
volumes is listed in Table 4-7. If any default is too small for your needs, see 
the RT-11 Installation and System Generation Guide for details on changing 
this default directory size. 

If the volume you are initializing has protected files, the system always prints 
a confirmation message as in the following example. 

.:i:n:i:t rko: 

RK0!/:[n:i.t:i.8:i.i2e5 Are you sure? Y <RET> 

Volume contains protected files? Are you sure'!' Y <RF7> 

/BADBLOCKS[:RET] Use this option to scan a volume (disk or DECtape) 
for bad blocks and write .BAD files over them. For each bad block the system 
encounters on the volume, it creates a file called FILE.BAD to cover it. After 
the volume is initialized and the scan completed, the directory consists of only 
FILE.BAD entries to cover the bad blocks. This procedure ensures that the 
system will not attempt to access these bad blocks during routine operations. 
If the system finds a bad block in either the boot block or the volume direc- 
tory, it prints an error message and the volume is not usable. DIGITAL 
recommends that you use the DIRECTORY/BADBLOCKS command after 
using the INITIALIZE/BADBLOCKS command so that you can find out 
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where the bad blocks are, if any. The following command initializes volume 
RKl: and scans for bad blocks. 

. INITIALIZe-ZBAriEfLOCKS RKlt 

FilKl '/Initialize J Are your sure? Y 

If you use /BADBLOCKS:RET, the system will retain through initialization 
all files with a .BAD file type that it finds on the volume, giving them the 
name FILE.BAD. The system does not do a bad block scan. The advantage in 
using :RET is that initializing takes less time. Note that some volumes sup- 
port bad block replacement; DIGITAL recommends you use the /IRE- 
PLACE [: RET] option instead of /BADBLOCKS[:RET] for these volumes 
when scanning for bad blocks. 

If you use INITIALIZE/BADBLOCKS with a volume that has been previ- 
ously initialized with the INITIALIZE/REPLACE command, .BAD files will 
be written over all bad blocks and the bad block replacement table will be 
ignored by the system. 

If the volume being initialized contains bad blocks, the system prints the 
locations of the bad blocks in octal and in decimal, as in the following 
example: 

.INITIALIZE/BADBLOCKS RKO: 

R K : / 1 1-1 i t i a 1 i 2 e i Are •/ o u sure? Y 

B 1 c K T V p e 

000120 80. Hard 

0001^71 313. Hand 

000521 337. Hard 

?DUP-I-Bad blooKs detected 3. 

The left column lists the locations in octal, and the middle column lists the 
locations in decimal. The right column indicates the type of bad block found: 
hard or soft. 

/DOS Use this option to initialize a DECtape for DOS-11 format. 

/FILE:filespec Use this option to initialize a magtape and create a boot- 
able tape. For filespec, substitute dev:MBOOT.BOT. This file is distributed 
with RT-11 for this purpose only. Consult the RT-11 Installation and Sys- 
tem Generation Guide for more information. The following example creates 
a bootable magtape. 

. INITIALIZE/FILEiMBDOT.FiOT MTO! 

/INTERCHANGE Use this option to initialize a diskette for interchange 
format. The following example initializes DXl: in interchange format. 

. INITIALIZE/ INTERCHANGE riX:l, : 
riXi;/In:i.t Are ^jou sure? Y 
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NOTE 

The directory of an initialized interchange diskette has a single 
file entry, DATA, that reserves the entire diskette. You must 
delete this file before you can write any new files on the disk- 
ette. Do this by using the following command: 

DELETE/INTERCHANGE DXliDATA 

This is necessary for IBM compatibility. 

/QUERY This option prompts you for confirmation before it initializes a 
device. Respond by typing a Y followed by a carriage return to initiate execu- 
tion of the command. The system interprets a response beginning with any 
other character to mean NO. /QUERY is the default operation. 

/NOQUERY Use this option to suppress the confirmation message the sys- 
tem prints before it proceeds with the initialization. 

/REPLACE [: RET] If you have an RK06, RK07, RLOl, or RL02 disk, use this 
option to scan a disk for bad blocks. If the system finds any bad blocks, it 
creates a replacement table so that routine operations access good blocks 
instead of bad ones. Thus, the disk appears to have only good blocks. Note, 
though, that accessing this replacement table slows response time for routine 
inp)ut and output operations. With /REPLACE, you have the option of decid- 
ing which bad blocks you want replaced if there is a replacement table over- 
flow. The RK06s and RK07s support up to 32 bad blocks in the replacement 
table; the RLOls and RL02s support up to 10. 

With an RK06 or RK07 disk, the system can replace only those bad blocks 
that generate a bad sector error (BSE). Of the blocks the system cannot 
replace, the system can report a bad block as being hard or soft. If you use 
/VERIFY with /REPLACE and the system still cannot use the block, the 
system reports a hard bad block. If the system can use the block, it reports a 
soft bad block. 
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With an RLOl or RL02 disk, the system can replace any kind of bad block. 

When you use /REPLACE, the system prints a list of replaceable bad blocks 
as in the following sample: 

. INITIALIZE/REPLACE DLOJ 
Block Twp© 



0;?0722 


12754. 


F\'eplaceabl«! 


11 5046 


39462. 


F^'eplaceatal*; 


13:W>17 


46991. 


ReF'lacsiifble 


1S6175 


48253 . 


Replaceable? 


136277 


4B319. 


Replaceable? 


13A401 


48385. 


Replaceable? 


140405 


49413. 


Replaceable? 


146252 


52394. 


Replaceable? 



DUP-I-Bad blacks detected 8. 



If there is a replacement table overflow, the system prompts you to indicate 
which blocks you want replaced as follows: 

? D IJ P - W - R e p 1 a c e m e n t tm b 1 e o v e r f 1 o w 
Type < R E T > y y o r n n n n n fi ( < R E T > ) 
Replace block # 

nnnnnn represents the octal number of the block you want the system to 
replace. 

After you enter a block number, the system responds by repeating the 
Replace block # prompt. If you type a at any time you do not want any 
more blocks replaced, prompting ends and any blocks not placed in the 
replacement table are marked as FILE. BAD. 

If you enter a carriage return at any time, the system places all bad blocks 
you have not entered into the replacement table, starting with the first on 
the disk, until the table is full. The system assigns the name FILE. BAD to 
any remaining bad blocks and prompting ends. 

If you use /NOQUERY with /REPLACE, and there is a replacement table 
overflow, the effect will be as if you had entered a carriage return in 
response to the first Replace block # prompt. 

If you use :RET with /REPLACE, the system initializes the volume and 
retains the bad block replacement table (and FILE. BAD files) created by the 
previous /REPLACE command. 

Note that if the monitor file resides on a block that contains a bad sector 
error (BSE) and you are doing bad block replacement, a boot error results 
when you attempt to bootstrap the system. In this case, move the monitor. 
Use the DIRECTORY/BADBLOCKS/FILES command to determine which 
files reside on bad blocks. 

/RESTORE Use this option to uninitialize a volume. That is, you can use 
this option to restore the directory and files that were present on the volume 
prior to the previous initialization. You can use /RESTORE only if no files 
have been transferred to the volume since the last time it was initialized. 
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The /RESTORE option does not restore the boot blocks; so if you use 
/RESTORE to restore a previously bootable volume, use the COPY/BOOT 
command to make the volume bootable again. 

/SEGMENTS:!! Use this option if you need to initialize a disk and also 
change the number of directory segments. The number of segments in the 
directory establishes the number of files that can be stored on a device. The 
system allows a maximum of 72 files per directory segment, and 31 directory 
segments per device. The argument n represents the number of directory 
segments. The valid range for n is from 1 to 31 (decimal). Table 4-7 shows 
the default values of n for standard RT-11 devices. 

Table 4—7: Default Directory Sizes 





Size (decimal) of 


Device 


Directory in Segments 


RK 


16 


DD 


1 


DT 


1 


RF 


4 


DS 


4 


DP 


31 


DX 


1 


DM 


31 


DY 


4 


DL 


16 


PD 


1 



/VOLUMEID[:ONLY] Use /VOLUMEID to write a volume identification 
on a device when you initialize it. This identification consists of a volume ID 
(up to 12 characters long for a block-replaceable device, up to 6 characters 
long for magtape) and an owner name (up to 12 characters long for a block- 
replaceable device, up to 10 characters long for magtape). The follov/ing 
example initializes device RKl: and writes a volume identification on it. 

. INITIAL I Z;E/V0LUM£- ID F^lKl : 

F? K 1 ; / 1 n i. t :i. 3 1 :i. z e ? A r e w o i. j !:> u r e ? Y 

Volume ID? FORTRAN VOL. 

Owner? Marcy 

Use /VOLUMEID:ONLY to write a new volume identification on a device 
without reinitializing the device. You cannot change the volume ID of a 
magtape or cassette without initializing the entire tape. 

/WAIT The /WAIT option is useful if you have a single-disk system. When 
you use this option to initialize a volume, the system begins the procedure 
but then pauses and waits for you to mount the volume you want to 
initialize. When the system pauses, it prints the following prompt at the 
terminal: 

Mount input volume :i.n <':l©vice>si Continue? 
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<device> is the name of the device into which you mount the volume to be 
initialized. After you have mounted the input volume, type Y followed by a 
carriage return. After the system completes the initialization process, it 
prints the following message prompting you to mount the system volume: 

Mount <r>wstem volume in <device>v Cont:i.nue? 

After you mount the system volume, type Y followed by a carriage return. 
When you use /WAIT, make sure that DUP is on the system volume. 
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The INSTALL command installs the device you specify into the system. 



INSTALL ( SP ) device I,, device] 



In the command syntax shown above, device represents the name of the 
device to be installed. The INSTALL command accepts no options. It allows 
you to install into the system tables a device that was not installed into the 
system when it was bootstrapped. (A device handler must exist in the sys- 
tem tables before you can use that device.) The device occupies the first 
available device slot. Using the INSTALL command does not change the 
monitor disk image; it only modifies the system tables of the monitor that is 
currently in memory. 

You can enter the command on one line, or you can rely on the system to 
prompt you for information. The INSTALL command prompt is Device?. 

When you specify a device name, the system searches the system device for 
the corresponding device handler file. For SJ and FB systems, if LP: is to be 
installed, the INSTALL command searches for the file SY:LP.SYS. For XM 
systems, INSTALL searches for SY:LPX.SYS. The INSTALL command does 
not allow a device handler built for a different configuration of the system to 
be installed in a given system. Note that you cannot install the device 
names SY, DK, or BA. 

To permanently install a device, include the INSTALL command in the 
standard, system startup indirect command file. This file is invoked auto- 
matically when you boot the system. The INSTALL command also allows 
you to configure a special system for a single session without having to 
reconfigure to revert to the standard device configuration. If there ares no 
free device slots (use the SHOW DEVICES command to ascertain this), you 
must remove an existing device (with the REMOVE command) before you 
can install a new device. 

The following command installs the card reader into the system tables from 
the file CR.SYS. (The colon (:) that follows the device handler name is 
optional.) 

.:tNSTALi... cr: 

The next example installs the line printer, the card reader, and DECtape. 

.INSTALL LF'J ?CR: ,mt 
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The LIBRARY command lets you create, update, modify, list, and maintain 
library files. 



LIBRARY 



' /LIST [:filespeo| |/ALLOCATE:sizel H ( SP ) library [( SP ) fllespecs [f ™^^':*^^ }11 
;|N01 OBJECT [:filespecl t/ALLOCATEisizel '^^ LUUPDATE JJJ 



/CREATE 
/EXTRACT 
/INSERT 
/MACRO J 

/DELETE 
/PROMPT 
/REMOVE 



In the command syntax illustrated above, library represents the library file 
name, and filespecs represents the input module file names. Separate the 
library file specification from the module file specifications with a space. 
Separate the module file specifications with commas. The system uses .LST 
as the default file type for library directory listing files. It uses .OBJ as the 
default file type for object libraries and object input files, and .MAC for 
macro libraries and macro input files. Object libraries contain machine-level 
object modules, and macro libraries contain MACRO source modules. You 
cannot combine object modules with MACRO modules. The default oper- 
ation, if you do not specify an option, is /INSERT. If you do not specify a 
library file in the command line, the system prompts Library?. If you specify 
/CREATE, /INSERT, or /MACRO and omit the module file specification, the 
system prompts Files?. If you specify /EXTRACT, the system prompts File?. 
Note that no other option causes the File? or Files? prompt. 

The LIBRARY command can perform all the functions listed above on object 
library files. It can also create macro library files for use with the 
MACRO-11 assembler. A library file is a direct-access file (a file that has a 
directory) that contains one or more modules of the same type. The system 
organizes library files so the linker and MACRO-11 assembler can access 
them rapidly. Each library is a file that contains a library header, library 
directory, and one or more object modules. The object modules in a library 
file can be routines that are repeatedly used in a program, routines that are 
used by more than one program, or routines that are related and simply 
gathered together for convenience. An example of a typical object library file 
is the default system library, SYSLIB.OBJ, used by the linker. An example 
of a macro library file is SYSMAC.SML. 

You access object modules in a library file by making calls or references to 
their global symbols; you link the object modules with the program that uses 
them by using the LINK command to produce a single executable module. 
Each input file for an object library consists of one or more object modules, 
and is stored on a device under a specific file name and file type. Once you 
insert an object module into a library file, you no longer reference the mod- 
ule by the file name of which it was a part; reference it by its individual mod- 
ule name. For example, the input file FORT.OBJ may exist on DT2: and can 
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contain an object module called ABC. Once you insert the module into a 
library, reference only ABC, and not FORT. OBJ. 

The input files normally do not contain main programs but only subprograms, 
functions, and subroutines. The library file must never contain a FORTRAN 
BLOCK DATA subprogram because there is no undefined global symbol to 
cause the linker to load it automatically. 

The following sections describe the LIBRARY command options and explain 
how to use them. The last section under this command describes the 
LIBRARY prompting sequence and order of execution for commands that 
combine two or more LIBRARY options. Chapter 12 contains more detailed 
information on object and macro libraries. 

/ALLOCATE: size Use this option only with /LIST or /OBJECT to reserve 
space on the device for the output file. The value size represents the number 
of blocks of space to allocate. The meaningful range for this value is from 1 to 
32767. A value of -1 is a special case that allocates the largest area available 
on the device. 

The following example uses /ALLOCATE to create the object library 
MYLIB.OBJ from the object library MYFILE.OBJ. The argument, -1, is 
specified with /ALLOCATE. 

I. . i: B r;: A FJ Y / B , J i;;: c; T : M Y 1... ;i: B / A 1. 1... c A T i;;: ; - 1 m y f ■ :i: i... e 

/CREATE Use this option by itself to create an object library. Specify a 
library name followed by the file specifications for the modules that are to be 
included in that library. The following command creates a library called 
NEWLIB.OBJ from the modules contained in files FIRST.OBJ and SEC- 
OND. OBJ. 
. I... :i: B R A ri y / c; r i;; a t i;;: n i;i: w i. :i: b i-- :i: r s j , s e c o n n 

/DELETE Use this option to delete an object module and all its associated 
global symbols from a library file directory. Since the module is deleted only 
from the directory (and not from the object module itself), the module and all 
global symbols that were previously deleted are restored whenever you update 
that library, unless you use /DELETE again to delete them. Specify the 
library name in the command line. The system prompts you for the names of 
the modules to delete. The prompt is: 

Module name? 

Respond with the name of a module. (Be sure to specify a module name and 
not a global name.) Follow each module name with a carriage return. Enter a 
carriage return on a line by itself to terminate the list of module names. The 
following example deletes modules SON and TAN from the library called 
NEWLIB.OBJ. 

.L I BRAR Y/DELETE NEWI... X B 
h o d I.J .1. (? n s irp <■:■> ? !:> (v N 
Module name? TAN 
Modul. e name? 

/EXTRACT Use this option to extract an object module from a library and 
store it in a file with the same name as the module and a file type of .OBJ. 
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You cannot combine this option with any other option. The system prompts 
you for the name of the object module to be extracted. The prompt is: 



Olobal? 

If you specify a global name, the system extracts the entire module of which 
that global is a part. Follow each global name with a carriage return. Enter 
a carriage return on a line by itself to terminate the list of global symbols. 
The following example shows how to extract the module ATAN from the 
library called NEWLIB.OBJ and store it in file ATAN.OBJ on DXl:. 

.LIBRARY/EXTRACT 
Librarw? NEUILIB 
File.; ? DXIIATAN 
Global Y ATAN 
Global ? 

/INSERT Use this option to insert an object module into an existing 
^_-/ library. Although you can insert object modules that have duplicate names, 

this practice is not recommended because of the difficulty involved in replac- 
ing or updating these modules. Note that /INSERT is the default operation. 
If 3^ou do not specify any option, insertion takes place. The following 
example inserts the modules contained in the files THIRD. OBJ and 
FOURTH.OBJ into the library called OLDLIB.OBJ. 

. LIBRARY/INSERT OLDLIB THIRD » FOURTH 

^ ^ /LIST[:fllespec] Use this option to obtain a directory listing of an object 

^^ library. The following example obtains a directory listing of OLDLIB.OBJ 

on the terminal (the line printer is the default device). 

. library/lxststt: olulib 

The directory listing prints global symbol names. A plus sign ( + ) in the 
module column indicates a continued line. See Section 12.2.7 for a procedure 
to include module names in the directory listing. 

^^1^0^ You can also use /LIST with other options (except /MACRO) to obtain a 

directory listing of an object library after you create or modify it. The follow- 
ing command, for example, inserts the modules contained in the files 
THIRD.OBJ and FOURTH.OBJ into the library called OLDLIB.OBJ; it 
then prints a directory listing of the library on the terminal. 

.library/insert/liststt; oldltb third » fourth 

You cannot obtain a directory listing of a macro library. 

Make sure when you use /LIST with LIBRARY that you use it on the com- 
mand side of the command string, and not after the file specification. 

/MACRO Use this option tci create a macro library. Note that this is the 
only valid function for a macro library. You can create a macro library, but 
you cannot list or modify it. To update a macro library, simply edit the 
AS(ni text file and then reprocess the file with the LIBRARY/MACRO corn- 
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mand. The following example creates a macro library called NEWLIB.MAC 
from the ASCII input file SYSMAC.MAC. 

.LIi:iRARY/MACR(VCREATE NEULIB SYSMAC 

When you use /MACRO with LIBRARY, use it on the command side of the 
command string, and not after the file specification. 

/OB JECT[:filespec] The system creates object library files by default els a 
result of executing a LIBRARY command. When you modify an existing 
library, the system actually makes the changes to the library you specify, 
thus creating a new, updated library that it stores under the same names as 
the original library. Use this option to give a new name to the updated 
library file and preserve the original library. The following example creates 
a library called NEWLIB.OBJ, which consists of the library OLDLIB.OBJ 
plus the modules that are contained in files THIRD.OBJ and FOURTH.OBJ. 

. L :[ IBRARY/ INSERT/OB JECT : NEWL X B OLDL :i: B TH I RD > FOURTH 

/NOOBJECT Use this option to suppress the creation of a new object 
library as a result of a LIBRARY command. 

/PROMPT Use this option to specify more than one line of input file speci- 
fications in a LIBRARY command. This option is valid with all other library 
functions except the /EXTRACT option. You must specify // as the last input 
in order to terminate the input list. Note that the file specifications you 
enter after typing the /PROMPT option must conform to Command String 
Interpreter conventions. The following example creates a macro library 
called MACLIB.MAC from seven input files. 

♦LIBRARY/MACRO/PROMPT MACLIB A. B, C> B 

*EtF>G 

*// 

/REMOVE This option permits you to delete a specific global symbol fi-om 
a library file's directory. Since globals are deleted only from the directory 
(and not from the object module itself), all the globals that were previously 
deleted are restored whenever you update that library, unless you use 
/REMOVE again to delete them. This feature lets you recover a library if 
you have inadvertently deleted the wrong global. The system prompts you 
for the names of the global symbols to remove. The prompt is: 

Global? 

Respond with the name of a global symbol to be removed. Follow each global 
symbol with a carriage return. Enter a carriage return on a line by itself to 
terminate the list of global symbols. The following example deletes the glob- 
als GA, GB, GC, and GD from the library OLDLIB.OBJ. 



.LIBRARY/REMOVE 


OLBLIB 


(31oh<i!l? RA 




Global? GB 




Global? GC 




Global? GB 




Global? 
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/REPLACE Use this option to replace modules in an existing object 
library with modules of the same name contained in the files you specify. 
The following example replaces a module called SQRT in the library 
MATHLB.OBJ with a new module, also called SQRT, from the file called 
MFUNCT.OBJ. 

.LIBRARY MATHLB MFUNCT/REPLACE 

Note that the /REPLACE option must follow each file specification that con- 
tains a module to be inserted into the library. Note also that you can use 
/REPLACE only with a module(s), and never a library file(s). 

/UPDATE This option combines the functions of /INSERT and 
/REPLACE. Specify it after each file specification to which it applies. If the 
modules in the input file already exist in the library, the system replaces 
those library modules. If the modules in the input file do not exist in the 
library, the system inserts them. The following example updates the library 
OLDLIB.OBJ. 

.LIBRARY OLDLIB FIRST/UPDATE kSECOND/UPDATE 

Note that the /UPDATE option must follow each file specification to which it 
applies, and that you can use this option only with modules, not files. 

You can combine the LIBRARY options with the exceptions of /EXTRACT 
and /MACRO, which you cannot combine with most of the other functions. 
Table 4-8 lists the sequence in which the system executes the LIBRARY 
options and prompts you for additional information. 

Table 4—8: Execution and Prompting Sequence of 
LIBRARY Options 



Option 


Prompt 


/CREATE 




/DELETE 


Module name? 


/REMOVE 


Global? 


/UPDATE 




/REPLACE 




/INSERT 




/LIST 





The following example combines several options. 

L IBR ARY/L I ST J TT J /REMCW E/ 1 NEERT NEWL I B L I B2/REPLACE i- L I B3 

Global? SQRT 

Global? 

RT-ll LIBRARIAN y03.10 FRl 15-JI.)L-79 00J0(;);37 

NEWLIB FRI 15-JUL-79 00{08:3S 



MODULE 



GLOBALS 

COS 
DATAN 
ATAN 
DCOS 



GLOBALS 

BIN 

DATAN2 
ATAN2 
BSIN 



GLOBAL 
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The command executes in the following sequence: 

1. Removes global SQRT from NEWLIB 

2. Replaces any duplicates of the modules in the file LIB2.0BJ 

3. Inserts the modules in the file LIB3.0BJ 

4. Lists the directory of NEWLIB. OB J on the terminal 
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The LINK command converts object modules into a format suitable for load- 
ing and execution. 





_ 




LINK 


/[NOl EXECUTE [:filespecl [/ALLOCATE size] 


( SP) fjlespecs 




/MAP [:filespecl |/ALLOCATE:sizel (/WIDE;, 




/LDA 








/FOREGROUND |:slacksizel 








/FILL:n 








/BOTTOM:n 








/FILLn 








/RUN 








/STACK [:nl 








/ALPHABETIZE 






/|N01 BITMAP 






/BOUNDARYlvalue 






/DEBUG |:lilespec| 






/EXTEND:n 






/INCLUDE 






/LIBRARY:filespec 






/LINKLIBRARY:filespec 






/PROMPT 






/ROUNDin 






/SLOWLY 






/SYMBOLTABLE 






/TOP 






/TRANSFER [-.n] 






/XM 






— — 





The RT-11 system lets you separately assemble a main program and each of 
its subroutines without assigning an absolute load address at assembly 
time. The linker can then process the object modules of the main program 
and subroutines to relocate each object module and assign absolute 
addresses. It links the modules by correlating global symbols that are 
defined in one module and referenced in another, and it creates the initial 
control block for the linked program. The linker can also create an overlay 
structure (if you specify the /PROMPT option) and include the necessary 
run-time overlay handlers and tables. The linker searches libraries you 
specify to locate unresolved global symbols, and it automatically searches 
the default system subroutine library, SYSLIB.OBJ, to locate any remain- 
ing unresolved globals. Finally, the linker produces a load map (if you spec- 
ify /MAP) that shows the layout of the executable module. See Chapter 11 
for a more detailed explanation of the RT-11 linker. The linker also can pro- 
duce and STB file. 

In the command syntax illustrated above, filespecs represents the object 
modules to be linked. Each input module should be stored on a random- 
access device (disk, diskette, EiECtape, or DECtape II); the output device for 
the load map file can be any RT-11 device. The output for an .LDA file (if 
you specify /LDA) can also be any RT-11 device, even those that are not 
block replaceable, such as paper tape. 

The default file types are as follows: 



Load Module 
Map Output 
Object Module 



.SAV,.REL(/FOREGROUND), .LDA(/LDA) 

.MAP 

.OBJ 
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If you specify two or more files to be linked, separate the files by commas. 
The system creates an executable file with the same name as the first fil(2 in 
the input list (unless you use /EXECUTE to change it). 

The LINK command options and explanations of how to use them follow. 
Table 4-9 summarizes LINK prompting sequence for commands that com- 
bine two or more LINK options. 

Table 4-9: Prompting Sequence for LINK Options 



Option 


Prompt 


/TRANSFER 


Transfer symbol? 


/STACK 


Stack symbol? 


/EXTENDin 


Extend section? 


/BOUNDARY:value 


Boundary section? 


/ROUND:n 


Round section? 


/INCLUDE 


Library search? 



If you combine any of the options listed in Table 4-9, the system prompts 
you for information in the sequence shown in the table. Note that the 
Library search? prompt is always last. This is the only prompt that acctjpts 
more than one line as a response. For all the prompts, terminate your 
response with a carriage return. Terminate your list of responses to the 
Library search? prompt by typing an extra carriage return. Note that if the 
command lines are in an indirect file and the system encounters an endi-of- 
file before all the prompting information has been supplied, it prints the 
prompt messages on the terminal. 

/ALLOC ATE:size' Use this option with /EXECUTE or /MAP to reserve 
space on the device for the output file. The argument size represents the 
number of blocks of space to allocate. The meaningful range for this value is 
from 1 to 32767. A value of-1 is a special case that creates the largest file 
possible on the device. When used with /EXECUTE, /ALLOCATE is valid 
only when you are generating a .REL or .LDA file. 

/ALPHABETIZE When you use this option, the linker lists in the load 
map your program's global symbols in alphabetical order. 

/BITMAP Use this option if you want the linker to create a memory usage 
bitmap. This is the default setting. 

/NOBITMAP Use this option if you do not want the linker to create a 
memory usage bitmap. This option is useful if you are preparing your pro- 
gram for ROM storage and its code lies between locations 360 and 377 
inclusive .'/BITMAP is the default setting. 

/BOTTOM:n Use this option to specify the lowest address to be used by 
the relocatable code in the load module. The argument n represents a six- 
digit unsigned, even octal number. If you do not use this option, the linker 
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positions the load module so that the lowest address is location 1000 (octal). 
This option is invalid for foreground links. 

/BOUNDARY:value Use the /BOUNDARY option to start a specific pro- 
gram section on a particular address boundary. The system generates a 
whole number multiple of the value you specify for the starting address of 
the program section. The argument value must be a power of 2. The system 
extends the size of the previous program section to accommodate the new 
starting address for the specific section. When you have entered the com- 
plete LINK command, the system prompts you for the name of the section 
whose starting address you need to modify. The prompt is: 

B o u I'l d a r> « s e c t :i. on ? 

Respond with the appropriate program section name and terminate your 
response with a carriage return. 

/DEBUG[:fllespec] Use this option to link ODT (on-line debugging tech- 
nique, described in Chapter 21) with your program to help you debug it. If 
you supply the name of anottier debugging program, the system links the 
debugger you specify with your program. The system links the debugger low 
in memory relative to your program. 

/EXECUTE[:filespec] Use this option to specify a file name or device for 
the executable file. Because the LINK command creates executable files by 
default, the following two commands have the same meaning: 

•LINK MYPROG 

. LINK/EXECUTE MYPROG 

Both commands link MYPROG.OBJ and produce MYPROG.SAV as a 
result. The /EXECUTE option has different meanings when it follows the 
command and when it follows the file specification. The following command 
creates an executable file called PROGl.SAV on device RKl:. 

. L I NK/EXECUTE t RK :l. t PROG i. , PR0G2 

The next command creates an executable file called MYPROG.SAV on 
device DK:. 

LINK RTNl »RTN2i.MYPR0G/EXECUrE 

/NOEXECUTE Use this option to suppress creation of an executable file. 

/EXTEND:n This option allows you to extend a program section to a spe- 
cific octal value n. The resultant program section size is equal to or greater 
than the value you specify, dejjending on the space the object code requires. 
When you have entered the complete LINK command, the system prompts 
you for the name of the program section you need to extend. The prompt is: 

E ;•! tend <r> e c t i. o n 'I' 

Respond with the appropriate program section name, and terminate your 
response with a carriage return. 
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/FILL:n Use this option to initialize unused locations in the load module 
and place a specific octal value n in those locations. Note that the linker 
automatically initializes to unused locations in the load module; use this 
option to place another value in those locations. This option can be usefuil in 
eliminating random results that occur when a program references uninitia- 
lized memory by mistake. It can also help you to determine which locations 
have been modified by the program and which remain unchanged. 

/FOREGROUND[:stacksize] This option produces an executable file in 
relocatable (.RED format for use as a foreground job under the FB or XM 
monitor. You cannot use .REL files under the single-job system. This option 
assigns the default file type .REL to the executable file. The argument stack- 
size represents the number of bytes of stack space to allocate for the fore- 
ground job. The value you supply is interpreted as an octal number; specify 
an even number. Follow n with a decimal point (n.) to represent a decimal 
number. The default value is 128 (decimal) (or 200 octal) bytes of stack 
space. DIGITAL recommends that you allocate 256. bytes of stack space 
when linking a FORTRAN program to run in the foreground. 

/INCLUDE This option lets you take global symbols from any library and 
include them in the linked memory image. When you have entered the com- 
plete LINK command, the system prompts you for a list of global symbols to 
include in the load module. The prompt is: 

Library search? 

Respond by typing the global symbols to be included in the load module. 
Type a carriage return after each global symbol. Type a carriage return on a 
line by itself to terminate the list. This option forces modules that are not 
called by other modules to be loaded from the library. 

/LDA This option produces an executable file in LDA format. The LDA- 
format file can be output to any device, including those that are not block- 
replaceable, such as the paper tape punch or cassette. The default file type 
.LDA is assigned by /LDA to the executable file. This option is useful for files 
that you need to load with the Absolute Binary Loader. 

/LIBRARY This option is the same as /LINKLIBRARY. It is included 
here only for system compatibility. 

/LINKLIBRARY:filespec You can use this option to include the library 
file you specify as an object module library in the linking operation. Because 
the system automatically recognizes library files in the linking operation 
you do not normally need this option; it is provided for compatibility with 
the EXECUTE command. 

/MAP[:filespec] You must specify this option to produce a load map list- 
ing. The /MAP option has different meanings depending on where you put it 
in the command line. 

If you specify /MAP without a filespec in the list of options that immediately 
follows the command name, the system generates a listing that prints on the 
line printer. If you follow /MAP with a device name, the system creates a 
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map file on that device. If the device is a file-structured device, the system 
stores the listing file on that device, assigning it the same name as the first 
input file and a .MAP file type. The following command produces a load map 
on the terminal. 

.LINK/MAP : TT t MYPROG 

The next command creates a map listing file called MYPROG.MAP on RK3:. 

.L I NK/MAP : RK3 1 MYPROG 

If the /MAP option contains a name and file type to override the default of 
.MAP, the system generates a listing with that name. The following com- 
mand, for example, links PROGl and PR0G2, producing a map listing file 
called MAP.OUT on device DK:. 

.LINK/MAP {MAP. OUT PROGl »PR0G2 

Another way to specify /MAP is to type it after the file specification to which 
it applies. To link a file and produce a map listing file with the same name, 
use a command similar to this one. 

.LINK PROGl i. PR0G2/EX(!:CUTE/MAP 

The command shown above links PROGl and PR0G2, producing files 
PR0G2.SAV and PR0G2.MAP. If you specify a file name on a /MAP option 
following a file specification in the command line, it has the same meaning 
as when it follows the command. 

/PROMPT Use this option to enter additional lines of input. The system 
continues to accept lines of linker input until you enter two slashes (//). 
Chapter 11 describes the commands you can enter directly to the linker. 
Wh(m you use the /PROMPT option, note that successive lines of input must 
conform to CSI conventions (see Chapter 6, Command String Interpreter). 
The example that follows uses the /PROMPT option to create an overlay 
structure for the program CO SINE. MAC: 

.l:i:nk/prompt cosink 

)KTAN/0 j 1. 

*c;os.i./o!i 
*sin;?/o;2 

)(d...MI..3/0;2// 

The /PROMPT option also gives you a convenient way to create an overlaid 
program from an indirect file. The file ANT0N.COM contains these lines: 

A/PROMPT 
SUB:l,/o::i. 
suis2/o;:l 

SUB3i.SUB4/0S:l. 

// 

The following command produces an executable file, DK:A.SAV, and a link 
map on the printer. 

,L]:NK./MAP (3ANT0N 
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/ROUND:n This option rounds up the section you specify so that the size of 
the root segment is a whole number of the value n you supply. The argument 
n must be a power of 2. When you have entered the complete LINK com- 
mand, the system prompts you for the name of the section that you netsd to 
round. The prompt is: 

Round section? 

Respond with the appropriate program section name, and terminate your 
response with a carriage return. 

/RUN Use this option to initiate execution of the resultant .SAV file. This 
option is valid for background jobs only. Do not use /RUN with any opition 
that requires a response from the terminal. 

/SLOWLY This option instructs the system to allow the largest possible 
memory area for the link symbol table at the expense of making the link 
process slower. Use this option only if an attempt to link a program ftdled 
because of symbol table overflow. 

/STACK[:n] This option lets you modify the stack address, location 42, 
which is the address that contains the value for the stack pointer. W'^hen 
your program executes, the monitor sets the stack pointer (SP) to the con- 
tents of location 42. The argument n is an even, unsigned, six-digit, octal 
number that defines the stack address. When you have entered the complete 
LINK command, the system prints the following prompt message if you did 
not already specify a value for n: 

stack symbol, V 

Respond with the global symbol whose value is the stack address. You can- 
not specify a number at this point. Terminate your response with a carriage 
return. If you specify a nonexistent symbol, the system prints an error itnes- 
sage. It then sets the stack address to 1000 (for memory image files) or to the 
bottom address if you used /BOTTOM. 

/SYMBOLTABLE[:filespec] When you use this option, the linker creates 
a file that contains symbol definitions for all the global symbols in the load 
module. Enter the symbol table file specification as the third output sp(3cifi- 
cation in the LINK command line. If you do not specify a file name, the 
linker uses the name of the first input file and assigns a .STB file type;. By 
default, the system does not create a symbol table file. 

The following example creates the symbol table file BTAN.STB. 

.LINK BOB J y BOB J2 AOB J y BOB J/SYMBOLTAELE ! BT AN 

/TOP:vaIue Use this option to specify the highest address to be used by 
the relocatable code in the load module. The argument value represents an 
unsigned, even octal number. 

/TRANSFER[:n] The transfer address is the address at which a pro^rram 
starts when you initiate execution with R, RUN, FRUN, or SRUN. The 
/TRANSFER option lets you specify the start address of the load module. 
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The argument n is an even, unsigned, six-digit, octal number that defines 
the transfer address. When you have entered the complete LINK command, 
the system prints the following prompt message if you did not already spec- 
ify a value for n: 

Transfer s a m b o 1 ? 

Respond with the global symbol whose value is the transfer address. You 
cannot specify a number at this point. Terminate your response with a car- 
riage return. If you specify ei nonexistent symbol, an error message prints 
and the linker sets the transfer address to 1 so that the system cannot exe- 
cute the program. If the transfer address you specify is odd, the program 
does not execute after loading, and control returns to the monitor. 

/WIDE Use this option withi /MAP to produce a wide load map listing. Nor- 
mally, the listing is wide enough for three Global Value columns, which is 
suitable for paper with 72 or 80 columns. The /WIDE option produces a list- 
ings that is six Global Value columns wide, which is equivalent to 132 
columns. 

Table 4-9 lists the sequence in which the system prompts you for additional 
information when you combine LINK options. 

/XM When you use this option, you enable special .SETTOP and .LIMIT 
features provided in the XM monitor. This option allows a virtual job to map 
a scratch region in extended memory with the .SETTOP programmed 
request. See the RT-11 Programmer's Reference Manual and the RT-11 
Software Support Manual, foir more details on these special features. Do not 
use with /FOREGROUND. 

If you want to create an extended memory overlay structure for your pro- 
gram, use the /PROMPT option. You can then specify on subsequent lines 
the overlay structure using the LINK /V option (see Chapter 11 of this man- 
ual). Note that when you use /V to create an overlay structure, the linker 
automatically enables the special .SETTOP and .LIMIT features. 
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The LOAD command loads a device handler into memory for use with fore- 
ground, background, or system jobs, or BATCH. 



LOAD Qsp) device [ = jobnameI [. device [- jobnamell 



In the command syntax shown above, device represents the device handler to 
be made resident; jobname assigns the device handler to the background job if 
it has the value B, or to the foreground or system job if it has the value F. The 
jobname specification is invalid with the SJ monitor. Under a monitor that 
has system job support, jobname can be the logical job name of a system job. 

The LOAD command helps control system execution by bringing a device 
handler into memory and optionally allocating the device to a job. The system 
allocates memory for the handler as needed. Before you use a device in a 
foreground program with the FB monitor, or any device at all with the XM 
monitor, you must first load the device handler. A device can be owned 
exclusively by either the foreground, background, or system job. (Note that 
BATCH, if running, is considered to be a background job under the FB and 
XM monitors.) This exclusive ownership prevents the input and output of two 
different jobs from being intermixed on the same non-file-structured device. 
In the following example, magtape belongs to the background job, while DEC- 
tape is available for use by either the background, foreground, or system job; 
the line printer is owned by the foreground job. All three handlers are made 
resident in memory. 

.LOAD »T; ,mt^=BvLFt^-:F 

For a monitor with system job support, the following example reserves the line 
printer for the system job QUEUE. 

,1.0 AD LPJ^^aUEUE 

Different units of the same random-access device controller can be owned by 
different jobs. Thus, for example, DTI: can belong to the background job, 
while DT5: can belong to the foreground or system job. If no ownership is 
indicated, the device is available for public use. 

NOTE 

If you use the LOAD command to load a non-file-structured 
device handler, and assign ownership of that handler to a job, 
all units of that particular device become assigned to that job. 
This means no other job can use any unit of that particular 
device. 

To change ownership of a device, use another LOAD command. It is not 
necessary to first unload the device. For example, if the line printer has been 
loaded into memory and assigned to the foreground job as in the exaraple 
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above, the following command reassigns it to the background job without 
unloading the handler first. 

.LOAD i...p:=b 

Note, however, that if you interrupt an operation that involves magtape or 
cassette, you must unload (with the UNLOAD command) then load the 
appropriate device handler (MM, MT, MS, or CT). When using the MT han- 
dler with the FB monitor, this restriction does not apply. 

You cannot assign ownership of the system unit (the unit you bootstrapped) 
of a system device, and any attempt to do so is ignored. You can, however, 
assign ownership of other units of the same type as the system device. 
LOAD is valid for use with logical names. For example: 

.ASSIKN RK5 XY 

.LOAiJ xy;=^f 

If you are using a diskette, loading the necessary device handlers into mem- 
ory can improve system performance significantly, since no handlers need to 
be loaded dynamically from the diskette. Use the SHOW command to dis- 
play on the terminal the status of device handlers and device ownership. 
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The MACRO command invokes the MACRO assembler to assemble one or 
more source files. 



MACRO 


/LIST [ililsspecl [/ALLOCATE:slze| 

/tNOl OBJECT I:lilespecl |/ALLOCATE:size| 

/CROSSREFERENCE [:type[. . .:lypel) 
/DISABLE:value| .:valuel 
/ENABLE:value [. rvalue] 
/|N01 SHOW [:valuoI 


CsP) filespecs 


/LIBRARY 
/PASS:1 





In the command syntax shown above, filespecs represents one or more files to 
be included in the assembly. If you omit a file type for an input file, the sys- 
tem assumes .MAC. Output default file types are .LST for listing files and 
.OBJ for object files. 

To assemble multiple source files into a single object file, separate the files 
by plus ( + ) signs in the command line. Unless you specify otherwise, the 
system creates an object file with the same name as the first input file and 
gives it an .OBJ file type. To assemble multiple files in independent assem- 
blies, separate the files by commas (,) in the command line. This generates a 
corresponding object file for each set of input files. 

Language options are position-dependent — that is, they have different 
meanings depending on where you place them in the command line. Options 
that qualify a command name apply across the entire command stiring. 
Options that follow a file specification apply only to the file (or group of files 
separated by plus signs) that they follow in the command string. 

You can enter the MACRO command as one line, or you can rely on the sys- 
tem to prompt you for information. The MACRO command prompt is Files? 
for the input specification. The system prints on the terminal the number of 
errors MACRO detects during an assembly, as this printout shows: 



.MACR'O/CROSSREFERENCE 
ERFi'ORS DETECTEti: 



F'R0Gl+PRt)G2/L.lBT/C)BJEC;T 



Chapter 10 and the PDP-11 MACRO Language Reference Manual contain 
more detailed information about using MACRO. The options you can use 
with the MACRO command follow. 

/ALLOCATE :8ize Use this option with /LIST or /OBJECT to reserve 
space on the device for the output file. The argument size representsi the 
number of blocks of space to allocate. The meaningful range for this value is 
from 1 to 32767. A value of-1 is a special case that creates the largest file 
possible on the device. 

/CROSSREFERENCE[:type[...:type] Use this option to generate a sym- 
bol cross-reference section in the listing. This information is useful for pro- 
gram maintenance and debugging. Note that the system does not generate a 
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listing by default. You must also specify /LIST in the command line to get a 
cross-reference listing. The argument type represents a one-character code 
that indicates which sections of the cross-reference listing the assembler 
should include. Table 4-10 summarizes the arguments and their meaning. 

Table 4-10: Cross-reference Sections 



Argument 



Section Type 



S 
R 
M 
P 
C 
E 
no argument 



User-defined symbols 

Register symbols 

Macro symbolic names 

Permanent symbols (instructions, directives) 

Control sections (.(^SECT symbolic names) 

Error codes 

Equivalent to :S:M:E 



/DISABLE:value[...:value] Use this option to specify a MACRO .DSABL 
directive. See the PDP-11 MACRO Language Reference Manual for a 
description of the directive and a list of all legal values. Table 4—11 summa- 
rizes the arguments and their meaning. 



Table 4-11- 


.DSABL and .ENABL Directive Summary 


Argument 


Default 


Enables or Disables 


ABS 


disable 


Absolute binary output 


AMA 


disable 


Assembles all absolute addresses as relative addresses 


CDR 


disable 


Treats source columns 73 and greater 
as comments 


FPT 


disable 


Floating-point truncation 


GliL 


disable 


Treats undefined symbols as globals 


LG 


disable 


Accepts lower case ASCII input 


LSB 


disable 


Local symbol block 


PNC 


enable 


Binary output 


REG 


enable 


Mnemonic definitions of registers 



/ENABLE:value[...:value] Use this option to specify a MACRO .ENABL 
directive. See the PDP-11 MACRO Language Reference Manual for a 
description of the directive and a list of all legal values. Table 4—11 summa- 
rizes the arguments and their meaning. 

/LIBRARY This option identifies the file it qualifies as a library file; use it 
only after a library file specification in the command line. The MACRO 
assembler looks first to the library file or files you specify and then to the 
system library, SYSMAC.SML, to satisfy references (made with the 
.MCALL directive) from MACRO programs. In the example below, the com- 
mand string includes two user libraries. 

• MACRO MYLIBl/l..:rE<RARYfA+MYLIB2/l...:i:BRARYfB 

When MACRO assembles file A, it looks first to the library, MYLIBl.MAC, 
and then to SYSMAC.SML to satisfy .MCALL references. When it assem- 
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bles file B, MACRO searches MYLIB2.MAC, MYLIBl.MAC, and then SYS- 
MAC.SML, in that order, to satisfy references. 

/LIST[:filespec] You must specify this option to produce a MACRO assem- 
bly listing. The /LIST option has different meanings depending on where 
you place it in the command line. 

The /LIST option produces a listing on the line printer when /LIST follows 
the command name. For example, the following command line produces a 
line printer listing after compiling a MACRO source file: 

.MACRO/LIST MYPROB<RET> 

When the /LIST option follows the file specification, it produces a listing file. 
For example, the following command line produces the listing file 
DK:MYPROG.LST after compiling a MACRO source file: 

MACRO MYPROG/LISr<RET> 

If you specify /LIST without a file specification in the list of options that 
immediately follows the command name, the MACRO assembler generates 
a listing that prints on the line printer. If you follow /LIST with a device 
name, the system creates a listing file on that device. If the device is a file- 
structured device, the system stores the listing file on that device, assigning 
it the same name as the input file and a .LST file type. The following com- 
mand produces a listing on the terminal. 

,macro/i...tst:tt: a 

The next command creates a listing file called A.LST on RK3:. 

.MACRO/LIST ;RK3i; A 

If the /LIST option contains a name and file type to override the default of 
.LST, the system generates a listing file with that name. The following com- 
mand for example, assembles A.MAC and B.MAC together, producing files 
A.OBJ and FILEl.OUT on device DK:. 

,MACR0/I...IST;F1LE1. .OUT AfB 

You cannot use a command like the next one. In this example, the sec;ond 
listing file would replace the first one and cause an error. 

.MACR0/i...:rsrjFi:L.i;::2 Ai-b 

Another way to specify /LIST is to type it after the file specification to which 
it applies. To produce a listing file with the same name as a particular input 
file, you can use a command similar to this one: 

.MACRO A+B/LIBTSRK^; 

The above command assembles A.MAC and B.MAC, producing files 
DK:A.OBJ and RK3:B.LST. If you specify a file name on a /LIST option fol- 
lowing a file specification in the command line, it has the same meaning as 
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when it follows the command. The following two commands have the same 
results: 

• macro a/list sb 
.macro/i..,i:st;» a 

Both commands generate output files A.OBJ and B.LST. 

Remember that file options apply only to the file (or group of files that are 
separated by plus signs) they follow in the command string. For example: 

. MACRO A/I... I ST »B 

This command assembles A.MAC, producing A.OBJ and A.LST. It also 
assembles B.MAC, producing B.OBJ. However, it does not produce any list- 
ing file for the assembly of B.MAC. 

* 

/OBJECT[:filespec] Use this option to specify a file name or device for the 
object file. Because MACRO creates object files by default, the following two 
commands have the same meaning: 

. MACRO A 

. MACRO/OBJECT A 

Both commands assemble A.MAC and produce A.OBJ as output. The 
/OBJECT option functions like the /LIST option; it can be either a command 
or a file qualifier. 

As a command option, /OBJElCT applies across the entire command string. 
The following command, for example, assembles A.MAC and B.MAC sepa- 
rately, creating object files A.OBJ and B.OBJ on RKl:. 

. macro/object: RKl t ArB 

Use /OBJECT as a file option to create an object file with a specific name or 
destination. The following command assembles A.MAC and B.MAC 
together, creating files B.LST and B.OBJ. 

• MAC R A •*■ B / L :i: S T / B J E C T 

/NOOBJECT Use this option to suppress creation of an object file. As a 
command option, /NOOBJECT suppresses all object files; as a file option, it 
suppresses only the object file produced by the related input files. In this 
command, for example, the system assembles A.MAC and B.MAC together, 
producing files A.OBJ and B.LST. It also assembles C.MAC and produces 
C.LST, but does not produce C.OBJ. 

• MACRO A+B/LISTjC/NOOBJECT/LIST 

/PASS:1 Use this option on a prefix macro file to process that file during 
pass 1 of the assembly only, This option is useful when you assemble a 
source program together with a prefix file that contains only macro defini- 
tions, since these definitions do not need to be redefined in pass 2 of the 
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assembly. The following command assembles a prefix file and a source file 
together, producing files PROGl.OBJ and PROGl.LST. 

. MACRO PREFIX. MAC;/PASS: :ltF'R(:)G1./l..i:ST/0BJECT 

/SHOW:value Use this option to specify any MACRO .LIST directive. The 
PDP-11 MACRO Language Reference Manual explains how to use these 
directives. Table 4-12 summarizes the arguments and their meaning. Note 
that you must explicitly request a listing file with the /LIST option. 

Table 4-12: .LIST and .NLIST Directive Summary 



Argument 


Default 


Controls 


SEQ 


list 


Source line sequence numbers 


LOG 


list 


Locat^n counter 


BIN 


list 


Generated binary code 


BEX 


list 


Binary extensions 


SRC 


list 


Source code 


COM 


list 


Comments 


MD 


list 


Macro definitions, repeat range expansions 


MC 


list 


Macro calls, repeat range expansions 


ME 


nolist 


Macro expansions 


MEB 


nolist 


Macro expansions binary code 


CND 


list 


Unsatisfied conditionals, .IF and .ENDC statements 


LD 


nolist 


Listing directives with no arguments 


TOC 


list 


Table of Contents 


TTM 


line printer 
mode 


Output format 


SYM 


list 


Symbol table 



/NOSHOWrvalue Use this option to specify any MACRO .NLIST di]'ec- 
tive. The PDP-11 MACRO Language Reference Manual explains how to use 
these directives. Table 4-12 summarizes the valid arguments and tlieir 
meaning. Note that you must explicitly request a listing file with the /L][ST 
option. 
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The PRINT command lists the contents of one or more files on the line 
printer. 



PRINT 


;COPIES:n 

/DELETE 

/[NO] LOG 

/NEWFILES 

/PROMPT 

/QUERY 

/WAIT 

/(NO) FLAGPAGE 
^/NAME:jobname _^ 


(_ SP ) lllespecs 







In the command syntax illustrated above, filespecs represents the file or files 
to be printed. You can explicitly specify up to six files as input to the PRINT 
command. The system prints the files in the order in which you specify them 
in the command line. You can also use wildcards in the file specification. In 
this case, the system prints tht? files in the same order that they occur in the 
directory of the specified device. If you specify more than one file, separate 
the files by commas. If you omit the file type for a file specification, the sys- 
tem assumes .LST. You can sp»ecify the entire command on one line, or you 
can rely on the system to prompt you for information. The PRINT command 
prompt is FiZes?. 

If you are running QUEUE as either a foreground or system job, many of the 
PRINT commands are executed by this program, therefore, the keyboard 
monitor may return the dot p»rompt immediately. See Chapter 20, Queue 
Package, for more information. If QUEUE is not running, some PRINT 
options are invalid (as noted). Likewise, some PRINT options are invalid if 
QUEUE is running. You should use the LOAD command to assign own- 
ership of a non-file structured device to QUEUE so that another job and 
QUEUE will not intermix output on that device. 

The PRINT command options follow; they include command examples. 

/COPIES:n Use this option to print more than one copy of the file. The 
meaningful range of values for the decimal argument n is from 1 to 32 (1 is 
the default). This option must appear immediately after the PRINT com- 
mand, and not after the file specification. The following command, for 
example, prints three copies of the file REPORT.LST on the line printer. 

.PRINT/C0PIf-SJ3 RErPORT 

/DELETE Use this option to delete a file after it lists on the line printer. 
This option must appear following the command in the command line. The 
PRINT/DELETE operation does not ask you for confirmation before it exe- 
cutes. You must use /QUERY for this function. The following example 
prints PROGl.BAS on the line printer, then deletes it from DXl:. 

. PRINT/DELETE T.)Xi t PR0G1. . BAS 
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/FLAGPAGEm Use this option if you want banner pages for each file 
being printed, where n represents the number of banner pages you want; for 
each file. This option is valid only if you are running QUEUE. If you specify 
more than one file to be printed, QUEUE prints a banner page for each file. 

The banner page that QUEUE creates consists of a page showing the file 
name in large, block letters. The banner page also includes a trailer t;hat 
lists the job name, the date and time the job was output, the copy number 
and number of copies in the job, and the input file specification. 

NOTE 

If you use the PRINT command to output files, and QUEUE 
is running, you may get banner pages even when you do not 
specify /FLAGPAGE. This condition is due to a default 
value you can set when you run QUEMAN, the background 
job that serves as an interface between you and QUEUE. 
The QUEMAN /P option sets the default number of banner 
pages for output jobs, so that each time you output a job, 
you get banner pages. This condition remains in effect until 
you reset it with the QUEMAN /P option. For more infor- 
mation on QUEMAN and the /P option, see Chapter 20, 
Queue Package. 

The following example prints three banner pages for each file in the com- 
mand line. 

. PRINT/FLAGPAGE X 3 PROCU. . HAC v PROGI , LSI k PROGI . 3TB 

/NOFLAGPAGE Use this option if you do not want any banner pages 
printed for each of the files in the job you want printed. Use this option only 
if you are running QUEUE. This option is useful if you have previously set 
QUEMAN's /P option to create banner pages each time a job is output (see 
note above). The default setting is /NOFLAGPAGE unless you specify other- 
wise with the QUEMAN /P option. 

/LOG This option lists on the terminal the names of the files that are 
printed by the current command. Normally, the system prints a log only if 
there is a wildcard in the file specification. If you specify /QUERY, the query 
messages replace the log, unless you specifically type /LOG/QUERY in the 
command line. The following example shows a PRINT command and the 
resulting log. 

. PRINT/LOG/riEfLFrrE REPORT 
Fi les copied/deleted 5 
I:iK: REPORT. LST to LP; 

This option is invalid if QUEUE is running. 

/NOLOG This option prevents a list of the files copied from typing out on 
the terminal. You can use this option to suppress the log when you use a 
wildcard in the file specification. This option is invalid if QUEUIE is 
running. 
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/NAME:[dev:]jobname Us<; this option to specify a job name for the files 
you want printed. This option is valid only if you are running QUEUE. You 
can use up to six alphanumeric characters for the job name. If you do not use 
the /NAME option, the system uses the first input file name as the job name. 
If you specify a device with the job name, you can send the files to that 
device, permitting you to send files to any valid RT-11 device. If you send 
the files to a mass storage volume, the system uses the job name as the file 
name for the job, assigning a .JOB file type. Note that the handler for the 
output device must be loaded in memory (see the LOAD command 
description). 

The following example sends J0B5, consisting of FILEl.LST, FILE2.LST, 
andFILE3.LST,toDXl:. 

. F^'R :t NT/NAME 5 DX :l. ! JOBS F :i: U!- 1 , F I U;i:2 y F I \...E3 

The files from this example reside on DXl: as J0B5.J0B. 

/NEWFILES Use this option in the command line if you need to print only 
those files that have the current date. The following example shows a con- 
venient way to print all new files after a session at the computer. 

.PFi:tNT/NEWF:i:i...ES *.LST 
Files copied? 

i:iKS(:)UTF]:i..j..sT to i...p; 

i:iK J REPORT. LST to l.Pt 

This option is invalid if QUEUE is running. 

/PROMPT Use this option to continue a command string onto subsequent 
lines. This option is valid only if you are running QUEUE. When you use 
/PROMPT, you can enter file specifications on subsequent lines directly to 
QUEMAN, described in Chapter 20. Terminate the command with two 
slashes (//). 

The following example uses /PROMPT to print FILE1,FILE2,FILE3,FILE4, 
and FILES: 

.PRINT/PROMPT f:i:i...e:i. 
>kf:lile2v file;? 

*FTLE4 
*FILE5// 

/QUERY If you use this option, the system requests confirmation 
from you before it performs the operation. /QUERY is particularly useful on 
operations that involve wildcards, when you may not be sure which files the 
system selected for an operation. Note that if you specify /QUERY in a 
PRINT command line that also contains a wildcard in the file specification, 
the confirmation messages that print on the terminal replace the log mes- 
sages that would normally appear. You must respond to a query message by 
typing Y (or anything that betgins with Y) and a carriage return to initiate 
execution of a particular operation. The system interprets any other 
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response to mean NO; it does not perform the specific operation. The follow- 
ing example uses /QUERY. 

.PRINT/QUERY *.I...ST 

F:i. les copied: 
DK:OUTF-:tL.I...ST to LPt? N 
DK J REPORT. LST to LP J? Y 

This option is invalid if QUEUE is running. 

/WAIT This option is useful if you have a single-disk system. When you 
use this option, the system initiates the PRINT operation, but then pauses 
and waits for you to mount the volume from which you want the operation to 
take place. When the system pauses, it prints Mount input volume in 
<device>; Continue? . When the volume is mounted, type Y followed by a 
carriage return. 

The following command line prints ERREX.MAC from RKO: 

.PRINT/WAIT RKO : ERREX.MAC 

Mount .input volume in RKO IP Continue'i'Y 

Mount swstem volume in RKO J 5 Continue'i'Y 

In the case of PRINT, the system prints the file or files you specify before it 
prints Mount system volume in <device>; Continue? . Make sure when you 
use /WAIT that PIP is on the system volume. This option is invalid if 
QUEUE is running. 
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The R command loads a memory image file from the system device into 
memory and starts execution. 



R ( SP ) filespecs 



In the command syntax shown above, filespec represents the program to be 
executed. The default file type is .SAV. The only valid device is SY:. The R 
command is similar to the RUN command except that the file you specify in 
an R command string must be on the system device (SY:). Use the R com- 
mand only with background jobs including privileged jobs in XM. (Use 
FRUN to execute a foreground job under the FB or XM monitor.) The follow- 
ing command loads and executes MYPROG.SAV from device SY:. 

.R MYPROG 

The R command is the only raonitor command that can execute a back- 
ground virtual job under the XM monitor. The R command creates a virtual 
memory partition for the job, creates a region and window definition 
block, and sets up the user mapping registers. 
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The REENTER command starts the program at its reentry address (the 
start address minus 2). 






REENTER 



The REENTER command accepts no options or arguments. REENTER lioes 
not clear or reset any memory areas. Use it to avoid reloading the same pro- 
gram for subsequent execution. You can use REENTER to return to a sys- 
tem program or to any program that allows for a REENTER after the 
program terminates. You can also use REENTER after you have used two 
CTRL/Cs to interrupt those programs. 

If you issue the REENTER command and it is not valid, the message 
?KMON-F-Illegal command is printed. You must start that program with 
an R or RUN command. 

In the following example the directory program (DIR) lists the directory of 
DK: on the line printer. Two CTRL/Cs interrupt the listing and return tc» the 
monitor. REENTER starts DIR at its reentry address, and DIR prompts for a 
line of input. 

.R DIR 

)KLp:=--riK:*.* 



, Rt:i:-NTER 

* 

Note in the example above that using REENTER does not mean that the 
directory listing continues from where it was interrupted, only that the 
DIRECTORY program re-commences execution. 
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The REMOVE command removes a device name from the system tables. 



REMOVE ( SP ) device [,.. device] 



In the command syntax shov/n above, device represents the device to be 
removed from the system tables. The REMOVE command accepts no 
options. You can enter the REMOVE command on one line, or you can rely 
on the system to prompt you for information. The REMOVE command 
prompt is Device?. 

Using the REMOVE command does not change the monitor disk image; it 
only modifies the system tables of the monitor currently in core. This allows 
you to configure a special system for a single session at the computer with- 
out having to reconfigure to return to your standard device configuration. 
Bootstrapping the system device restores the original device configuration. 
To permanently REMOVE a device, include the REMOVE command in the 
standard system startup indirect command file. 

You cannot remove SY: (the handler for the system device), BA: (the 
BATCH handler), or TT: (the terminal handler). If you attempt to REMOVE 
a device that does not exist in the running monitor's system table, the sys- 
tem prints an error message. You can use the INSTALL command to install 
a new device after using the REMOVE command to remove a device (thus 
creating a free device slot). 

The following command removes the line printer handler and the card 
reader handler from the system. Note that the colons (:) are optional. 

Use the SHOW command to display on the terminal a list of devices that are 
currently available on your system. 
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The RENAME command assigns a new name to an existing file. 



RENAME 


((NO! LOG 

/[N0| PROTECTION 

/QUERY 

/[NOl REPLACE 

/SETDATE 

(SYSTEM 

/WAIT 


(SP) inputdlBspecs C SP ) outpuHilespecs 



In the command syntax illustrated above, input-filespecs represents the files 
to be renamed, and output-filespec represents the new name. You can specify 
up to six input files, but only one output file. Note that the device specifica- 
tion must be the same for input and output; you cannot rename a file from 
one device to another. If a file exists with the same name and file type as the 
output file you specify, the system deletes the existing file unless you use the 
/NOREPLACE option to prevent this. 

So that you do not rename system (.SYS) files by accident when you use a 
wildcard in the file specification, the system requires you to use the /SYS- 
TEM option when you need to rename system files. To rename files that 
cover bad blocks (.BAD files), you must explicitly give the file name and file 
type of the specified .BAD file. Since .BAD files cover bad blocks on a device, 
you usually do not need to rename or otherwise manipulate these files. 

Note that because of the file protection feature, you cannot execute any 
RENAME operations that result in deleting a protected file. For example, 
you cannot rename a file to the name of a protected file that already exists 
on the same volume. 

The options you can use with the RENAME command follow. 

/LOG This option lists on the terminal the files that were renamed by the 
current command. Normally, the system prints a log only if there is a wild- 
card in the file specification. If you specify /QUERY, the query messiages 
replace the log (unless you specifically type /LOG/QUERY in the command 
line). 

This example demonstrates logging. 

. re: NAME nxo : ( A* , mac * . for > 

Files r'<;>n<-:!mc:>d; 
ti X ; A B C .MAC t o D X S A Ifi C , F R 
nXOIAAF.MAC to DXOJAAF.FOR 

/NOLOG This option prevents a list of the files that are renamed from 
appearing on the terminal. 

/NEWFILES Use this option in the command line if you want to rename 
only those files that have the current date. This is a convenient weiy to 
access all new files after a session at the computer. 
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/PROTECTION Use this option to give a file protected status so that it 
cannot be deleted until you disable that status. Note that if a file is pro- 
tected, you cannot delete it irciplicitly. For example, you cannot perform any 
operations on a file that result in deleting a protected file. You can change a 
protected file's name, but not; its protected status, unless you also use the 
/NOPROTECTION option. 

/NOPROTECTION Use this option to enable a file for deletion. This 
option disables a file's protected status. 

/QUERY If you use this option, the system requests confirmation 
from you before it performs the operation. /QUERY is particularly useful on 
operations that involve wildcards, when you may not be sure which files the 
system selected for the operation. Using the /QUERY option also provides a 
quick way of performing operations on several files. For example, renaming 
several files is easier if you use /QUERY. You can then specify Y for each file 
you want renamed, as the following example shows. 



.RENAME/QUERY 


* . BAK 


*.hAf 






Files reniiiinei 


i; 








i:iK:pRi:iG:UBAK 


to DK!I 


■•RDGl, 


MAC 


? Y 


:riK;PR0G2.BAK 


to DKJI 


■•Roe2 


MAC 


'i> Y 


BK^PROGA.BAK 


to DKJI 


■■RDG6 


mac; 


'? Y 


DKtLMLSA.BAK 


to dk: 


Ml... 8 A 


MAC 


? 


DK!I...MI...9 .BAK 


to BKJ 


..ML 9 


MAC 


'!> Y 



Note that if you specify /QUERY in a command line that also contains a 
wildcard in the file specification, the confirmation messages that print on 
the terminal replace the log messages that would normally appear. You 
must respond to a query message by typing Y (or anything that begins with 
Y) and a carriage return to initiate execution of a particular operation. The 
system interprets any other i-esponse to mean NO; it does not perform the 
specific operation. The following example demonstrates querying. 

.RENAME/aUERY DXO J <p:CPJ. .SAU PIP.SAU) 
l~;i. 1.es renamodS 

dxo!p:i;pi.sav to bxojpip.sam ? y 

/REPLACE This is the default mode of operation for the RENAME com- 
mand. If a file exists with the; same name as the file you specify for output, 
the system deletes that duplicate file when it performs the rename 
operation. 

/NOREPLACE This option prevents execution of the rename operation if 
a file with the same name as the output file you specify already exists on the 
same device. The following example uses /NOREPLACE. In this case, the 
output file already existed and no action occurs. 

.RENAME/NOREPLACE BXO t TEST ., SAV DXO 5 BUP . SAV 

?P I P-UI- Output file founds no operation performed BXO : TEST .SAM 

/SETDATE This option causes the system to put the current date on all 
files it renames, unless the current system date is not set. Normally, the sys- 
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tern preserves the existing file creation date when it renames a file. The fol- 
lowing example renames files and changes their dates. 

.RENAME/SETDATE DXOJOK.FOR jK.OLD) 

F.i. les renamed { 
DX0 5ABC.F0R to DXO : ABC.OLD 
nX0 5AAF,F"C)F\' to DXO J AAF.OLD 
DX0:MER(3E.F0R to nXO: MERGE. OLD 

/SYSTEM Use this option if you need to rename system (.SYS) files. If you 
omit this option, the system files are excluded from the rename opersition 
and a message is printed on the terminal to remind you of this. This example 
renames MM.SYS to MX.SYS. 

.RENAME/SYSTEM DXOJMM.SYS DXOJMX.SYS 

/WAIT This option is useful if you have a single-disk system. When you 
use this option, the system initiates the RENAME operation, but then 
pauses and waits for you to mount the input volume on which the operation 
is to take place. When the system pauses, it prints Mount input volume in 
<deuice>; Continue? where <device> represents the device into which you 
mount the volume. When the volume is mounted, type Y followed by a car- 
riage return. 

The following command line renames PRIAM.TXT to NESTOR.TXT. 
PRIAM.TXT is on an RK05 disk. 

.rename/wa:i:t/nolog rko j pri am . txt nestor . txt 

Mount input volume :i.n RKO 55 Cont:i.nue'l'Y 
Mount sastwin volume .in RKO:; Continue/i'Y 



^WBf^ 
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RESET 

The RESET command resets several background system tables and does a 
gen(3ral clean-up of the background area. 



re;set 



The RESET command accepts no options or arguments. 

It causes the system to purge all open input/output channels, initialize the 
user program memory area, and release any device handlers that were not 
explicitly made resident with the LOAD command. It also disables CTRL/0, 
clears locations 40-53, and resets the KMON (keyboard monitor) stack 
pointer. Use RESET before you execute a program if a device or the monitor 
needs reinitialization, or when you need to discard the results of previously 
issued GET commands. The RESET command has no effect on the fore- 
ground or system job. The fcillowing example uses the RESET command 
before running a program. 

.RESET 
,R MYPROG 
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The RESUME command continues execution of the foreground or system job 
from the point at which a SUSPEND command was issued. 



^SP^ jobname 



If you have system job support enabled on your monitor, the RESUME com- 
mand must be followed by the name of the foreground or system job you wish 
to resume. (The RESUME command accepts logical job names.) If you do not 
have system job support enabled on your monitor, do not include the name of 
the foreground job you wish to resume. When you issue the RESUME com- 
mand, the foreground or system job enters any completion routines that 
were scheduled while the job was suspended. Note that RESUME is valid 
only with the FB and XM monitors. The following command resumes execu- 
tion of the foreground job that is currently suspended. 

.RESUMf- 

The next command resumes execution of the system job, QUEUE. SYS, that 
is currently suspended. 

.RESUME QUEUE 

You can also use the RESUME command to start a foreground job that you 
loaded with FRUN using /PAUSE. Likewise, you can use RESUME to start 
a system job that you loaded with SRUN using /PAUSE. 
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RUN 

The RUN command loads s. memory image file into memory and starts 
execution. 



(5D 



filespec 



(^P^ input-list ( ^SP} output-list 
( ^ SP ) argument 



In the command syntax illustrated above, filespec represents the program to 
be executed. The system assumes a .SAV file type for the executable file, 
which can reside on any RT-11 block-replaceable device. The default device 
is DK:. The RUN command automatically loads the device handler for the 
device you specify if it is not already resident. This eliminates the need to 
explicitly load a device handler when you run an overlaid program from a 
device other than the system device. The RUN command executes only those 
programs that have been linked to run as background jobs. (Use FRUN to 
execute foreground jobs under the FB or XM monitor.) 

RUN is a combination of the GET and START commands. First it loads a 
memory image file from a storage device into memory. Then it begins execu- 
tion at the program's transfer address. You can use RUN to execute a privi- 
leged job under the XM monitor the same way you execute any other 
background job in FB or SJ. However, a virtual job in XM requires special 
preparation for execution. You must use the R command to execute a back- 
ground virtual job. The R command creates a virtual memory partition for 
the job, creates a region and window definition block for the partition, 
and sets up the user mapping registers. The following command, for 
example, executes MYPROG.SAV, which is stored on device DXl:. 

.RUN DX:l. IMYPROG 

You can also pass an argument in the RUN command to the program, or 
specify a list of input and output. This allows you to specify a line of input for 
a user program or for a system utility program (which accepts file specifica- 
tions in the special syntax described in Chapter 6). The system automati- 
cally converts the input list and the output list you specify into a format that 
the Command String Interpreter accepts. For example, to execute the direc- 
tory program (DIR) and obtain a complete listing of the directory of DXl: on 
the printer, you can use the following command. 

.RUN d:i:r DX:I. j*.* lpj/e 
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This command has the same effect as the following lines. 



• RUN d:i:r 
>!ii.pj/i;;:=DX:i. ;*.* 



Note that when you use either an argument or an input list and output list 
with RUN, control returns to the monitor when the program completes. 
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The SAVE command writes memory areas in memory image format to the 
file and device that you specify. 



SAVE (s£) filespec ( SP ) parameters 



In the command syntax shown above, filespec represents the file to be saved 
on a block-replaceable device. If you do not specify a file type, the system 
uses .SAV. The parameters represent memory locations to be saved. 

Parameters are of the form: 

addre8s[-address(2)][,address(3)[-address(n)]] 
where: 

address is an octal value representing a specific block of memory 
locations to be saved. If you specify more than one address, 
each address must be higher than the previous one 

RT-11 transfers memory in 256- word blocks, beginning on 
boundaries that are multiples of 256 (decimal). If the loca- 
tions you specify make a block that is less than 256 words, 
the system saves additional words to make a 256-word block 

The system saves memory from location to the highest memory address 
specified by the parameter list or to the program high limit (location 50 in 
the system communication area). Initially, the system gives the start 
address and the Job Status Word the default value and sets the stack to 
1000. If you want to change these or any of the following addresses, you can 
use the Deposit command to alter them and the SAVE command to save the 
correct areas. 

Area Location 

Start address 40 

Stack 42 

JSW 44 

USR address 46 

High address 50 

Fill characters 56 

If you chartge the values of the addresses, it is your responsibility to reset 
them to their default values. For more information concerning these 
addresses refer to the RT-11 Programmer's Reference Manual. Note that 
the SAVE command does not write the overlay segments of programs; it 
saves only the root segment. You cannot use the SAVE command for fore- 
ground or virtual jobs. 
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The following command saves locations 10000 through 11777, and 14000 
through 14777. It stores the contents of these locations in the file 
FILEl.SAV on device DK:. 



< SAME FILE! 1.0000 U 000 y 14000- 141.00 



The next example sets the reenter bit in the JSW and saves locations 1000 
through 5777 in file PRAM.SAV on device SY:. 



.n 44=2000 

•SAVE SYiPRAM 1000-5777 
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The SET command changes device handler characteristics and certain system 
configuration parameters. 



SET ( SP} / physicaldevlco-name 1 ( SP ) condition [...condition] 



In the command syntax illustrated above, physical-device-name represents 
the device handler whose characteristics you need to modify. 

See Table 3-1 in this manual for a list of the standard RT-11 permanent 
device names. The argument item represents a system parameter that you 
need to modify. The system items you can change include error handling 
(SET ERROR) and wildcard handling (SET WILD). Table 4-13 lists the 
devices and items you can modify, as well as the valid conditions for these 
devices and items. If you set more than one condition for a device, separate 
the conditions with commas. With the exception of the SET TT, SET USR, 
and SET item commands, the SET command locates the file SY:device.SYS 
and permanently modifies it. The SET commands are valid for all three 
RT-11 monitors unless othervi^ise specified. They permanently modify the 
device handlers (except where noted); this means that the conditions remain 
set €!ven across a reboot. For those SET commands that do not permanently 
modify the device handlers, the conditions return to the default setting after a 
reboot. To make these settings appear. permanent, include the appropriate 
SET commands in your system's startup indirect command file (see Section 
4.3.3). The command you enter must be completely valid for the modification 
to take place. The SET command will modify only the device handler that 
corresponds to the currently booted monitor. For example, if you issue the 
SET command while running under the XM monitor, any device handlers 
modified will be of the form %%X.SYS. 

NOTE 

If a handler (except for TT:) is already loaded when you issue a 
SET command for it, you must unload the handler and load a 
fresh copy from the system device for the modification to have 
an effect on execution. 

The colon (:) after each device name is optional. 
Figure 4-2: Format of a 12- bit Binary Number 
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Table 4-13: SET Device Conditions and Modification 



Device or 
Item 



CR: 

CR: 
CR: 
CR: 
CR: 



CR: 



CR: 



CR: 



CR: 
CT: 



CT: 



DD: 



Condition 



CODE=n 

CRLF 
NOCRLF 
HANG 
NOHANG 



IMAGE 



NOIMAGE 



Modification 



TRIM 



NOTRIM 
RAW 



NORAW 



VECTOR =n 



Modifies the card reader handler to use either the DEC 026 or 
DEC 029 card codes. The argument n must be either 26 oi 29. 
The default value is 29. 

Appends a carriage return/line feed combination to each card 
image. This is the normal mode. 

Transfers each card image without appending a carriage 
return/line feed combination. The default is CRLF. 

Waits for you to make a correction if the reader is not ready at 
the start of a transfer. This is the normal mode. 

Generates an immediate error if the device is not ready at the 
start of a transfer. The handler waits (regardless of how the 
condition is set) if the reader is not ready at some point dur- 
ing a transfer (that is, the input hopper is empty, but an end- 
of-file card has not been read). The default is HANG. 

Causes each card column to be stored as a 12-bit binary num- 
ber, one column per word. The CODE option has no effect in 
IMAGE mode. Figure 4-2 illustrates the format of the li2-bit 
binary number. This format allows the system to read binary 
card images. It is especially useful if you use a special encod- 
ing of punch combinations. Mark-sense cards can be read in 
this mode. The default is NOIMAGE. 

Allows the normal translation (as specified by the CODE 
option) to take place. The system packs data one column per 
byte. It translates invalid punch combinations into the eirror 
character, ASCII backslash (\), which is octal code i34.Tl:Lis is 
the normal mode. 

Removes trailing blanks from each card that the system 
reads. You should not use TRIM and NOCRLF together 
because card boundaries become difficult to read. TRIM in the 
normal mode. 

Transfers a full 80 characters per card. The default is TRIM. 

Performs a read-after-write check for every record written. 
The system retries if an output error occurs. If three retries 
fail, the system indicates an output error. The default is 
NORAW. 

Writes every record directly without reading it back for veri- 
fication. This setting significantly increases transfer rates at 
the risk of increased error rates. This is the normal mode. 

Modifies the DECtape II handler to use n as the visctor 
address for the first DECtape II controller (n is an octal num- 
ber). This option, and the next three, enable you to set vector 
and Control and Status Register (CSR) values in the handler 
itself, without having to modify the handler source codei and 
reassemble. Use these options if you have installed the DEC- 
tape II controller(s) at nonstandard addresses. 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



Device or 
Item 



DD: 



DD: 



DD: 



EDIT 



EDIT 



EDIT 



EDIT 



ERROR 



Condition 



CSR = n 



VEC2=n 



CSR2 = n 



EDIT 



ERROR 



KED 



K52 



TECO 



WARNING 



ERROR 



Modification 



Modifies the DECtape II handler to use n as the CSR address 
for the first DECtape II controller. When you use this option, 
the system prints a message that indicates where to patch the 
DECtape II handler bootstrap, if you want to use a DECtape 
II as y(3ur system volume. 

ModifiiBs the DECtape II handler to use n as the vector for the 
second DECtape II controller. This option is valid only if you 
create the DECtape II dual controller handler (through sys- 
tem generation). 

Modifies the DECtape II handler to use n as the CSR address 
for the second DECtape II controller. This option is valid only 
if you create the DECtape II dual controller handler (through 
system; generation). 

Invokes the text editor EDIT with the keyboard monitor 
EDIT command. This is the normal mode. The system returns 
to this condition after a reboot. 

Invokes the Keypad Editor (KED). For more information on 
the Keypad Editor, see the PDP-11 Keypad Editor User's 
Guide. This condition is valid only for VTIOO terminals. The 
system returns to EDIT EDIT after a reboot. 

Invokes the Keypad Editor (K52); valid if your terminal is a 
VT52. For more information on the Keypad Editor, see the 
PDP-11 Keypad Editor User's Guide. The system returns to 
EDIT EDIT after a reboot. 

Invokes the text editor TECO with the keyboard monitor 
EDIT c:ommand. The default is EDIT. The system returns to 
that condition after a reboot. 

Causes indirect command files and keyboard monitor com- 
mands to abort if warnings, errors, or severe or fatal errors 
occur. See SET ERROR ERROR, which is the default setting. 
Warning error messages contain the -W- characters. The sys- 
tem returns to that condition after a reboot. 

Causes indirect command files and keyboard monitor com- 
mands that perform multiple operations (such as EXECUTE, 
which c;ombines assembling, linking, and running) to abort if 
errors or severe or fatal errors occur. This setting causes 
indirect files and keyboard monitor commands to abort on 
MACRO assembly errors. An example of an error is an unde- 
fined symbol in an assembly. An example of a severe error is a 
device that is write-locked when the system attempts to write 
to it. If either condition occurs, the indirect command file or 
keyboard monitor command aborts the next time the monitor 
gets control of the system. Error error messages contain the 
-E- characters. This is the normal setting. The system returns 
to this condition after a reboot. 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



Device or 
Item 



ERROR 



ERROR 



Condition 



SEVERE 



NONE 



LP: 



LP; 



LP: 



LP: 



CR 



NOCR 



CSR = n 



CTRL 



LP: 
LP: 



NOCTRL 
FORM 



Modification 



Causes indirect command files and keyboard monitor com- 
mands to abort only if severe or fatal errors occur. Severe 
error messages contain the -F- characters. See SET ERROR 
ERROR, which is the default setting. The system returns to 
that condition after a reboot. 

Allows indirect command files and keyboard monitor com- 
mands to continue to execute even though they contain sig- 
nificant errors. Most monitor fatal errors still cause the 
indirect command file or keyboard monitor command to 
abort. Fatal errors that always abort indirect command files 
contain the -U- characters in the error messages. See SET 
ERROR ERROR, which is the default setting. The system 
returns to that condition after a reboot. 

Sends carriage returns to the printer. To allow overstrihing 
on the printer, use this condition for any FORTRAN progi-am 
that uses formatted input and output. Use CR also for any 
LSll or LP05 line printer to prevent loss of the last line in the 
buffer. LP NOCR is the normal mode. 

Prevents the system from sending carriage returns to the 
printer. This setting produces a significant increase in print- 
ing speed on LPll printers, where the line printer controller 
causes a line feed to perform the functions of a carriage 
return. This is the default setting. 

Modifies the line printer handler to use n as the Control and 
Status Register (CSR) address for the line printer controller. 
The value you supply must be an octal word address not less 
than 160000. This option enables you to set a special (3SR 
value in the line printer handler itself, without havin;g to 
modify and reassemble the handler source code. Use this 
option if you have installed the line printer controller at a 
nonstandard address. 

Passes all characters, including nonprinting control charac- 
ters, to the printer. Use this condition to pass the bell charac- 
ter to the LA180 printing terminal. You can use this mode for 
LSll line printers. (Other line printers print a space for a 
control character.) The default is NOCTRL. 

Ignores nonprinting control characters. This is the normal 
mode. 

Declares that the line printer has hardware form feeds, caus- 
ing the line printer handler to send form feeds to the con- 
troller. When you use this option, the line printer handler 
sends the form feed character to the printer each time the 
handler encounters a form feed. This is the default setting. 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



SET 



Device or 
Item 



LP: 



LP: 

LP: 
LP: 



LP: 
LP: 

LP; 
LP: 

LP: 



LP: 
LP: 
LP: 



Condition 



Modiflcation 



NOFORM 



FORMO 

NOFORMO 
HANG 



NOHANG 
LC 

NOLO 
LENGTH=n 

SKIP=n 



TAB 



NOTAB 



VECTOR=n 



Causes the line printer handler to simulate hardware form 
feeds by sending one or more line feeds to the printer. When 
you use this setting, you must also use the LENGTH=n set- 
ting and position the paper at the top of a form (that is, at the 
page perforation) before you start to use the printer. Using the 
NOFORM condition is useful if you are using a preprinted 
form that has a nonstandard length. You must use this setting 
if your printer does not accommodate form feeds. FORM is the 
default setting. 

Issues a form feed before a request to print block 0. This is the 
normal mode. 

Turns off FORMO mode, which is the default. 

Waits for you to make a correction if the line printer is not 
ready or is not ready at some point during printing. If you 
expect output from the line printer and the system does not 
respond or appears to be idle, check to see if the line printer is 
powersd on and ready to print. This is the normal mode. 

Generates an immediate error if the line printer is not ready. 
The default is HANG. 

Allows; the system to send lower-case characters to the printer. 
Use this condition if your printer has a lower-case character 
set. The default is NOLC. 

Translates characters in lower case to upper case before print- 
ing. This is the normal mode. 

Causes the line printer to use n as the number of lines per 
page. The default number of lines per page is 66. Use this 
option with the NOFORM and SKIP=n settings. 

Causes the line printer handler to send a form feed to the 
printej- when it comes within n lines of the bottom of a page. 
Use this setting to prevent the printer from printing over page 
perforations. The value you supply for n should be an integer 
from to the maximum number of lines on the paper. If you 
set SKIP=0, the handler sends lines to the printer regardless of 
the position of the paper. If you have set SKIP to a value other 
than 0, set SKIP=0 to disable this condition. When you use 
this setting, you must also use the LENGTH=n setting. The 
default: is SKIP=0. 

Sends TAB characters to the line printer. The default is 
NOTAB. 

Expands TAB characters by sending multiple spaces to the 
line printer. This is the normal mode. 

Modifies the line printer handler to use n as the vector of the 
line printer controller. The value you supply for n must be an 
even octal address below 500. This option enables you to set a 
special vector value in the line printer handler itself, without 
having to modify the handler source code and reassemble. Use 
this option if you have installed the line printer controller at a 
nonstandard address. 



I 
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Table 4-13: 



SET Device Conditions and Modification (Cont.) 



Device or 
Item 



LP: 



LS: 



LS: 



LS: 



LS: 

LS: 

LS: 



LS: 



Condition 



WIDTH = n 



CR 



NOCR 



CSR = n 



CTRL 

NOCTRL 
FORM 



LS: 

LS: 
LS: 



NOFORM 



FORMO 

NOFORMO 
HANG 



Modification 



Sets the line printer width to n, where « is a decimal integer 
between 30 and 255, inclusive. The system ignores any char- 
acters that print past column n. The default is 132. 

Sends carriage returns to the printer. To allow overstriking 
on the printer, use this condition for any FORTRAN prog]-am 
that uses formatted input and output. (Use CR also for any 
LSll or LP05 line printer to prevent loss of the last line in the 
buffer.) This is the normal mode. 

Prevents the system from sending carriage returns to the 
printer. This setting may produce a significant increas(5 in 
printing speed on some line printers. Where the printer con- 
troller causes a line feed to perform the functions of a carriage 
return. The default is CR. 

Modifies the line printer handler to use n as the Control and 
Status Register (CSR) address for the printer controller. The 
value you supply for n must be an octal word address not less 
than 160000. This option enables you to set a special (DSR 
value in the printer handler itself, without having to modify 
the handler source code and reassemble. Use this option if 
you have installed the printer controller at a nonstandard 
address. 

Passes all characters, including nonprinting control charac- 
ters, to the printer. Use this condition to pass the bell charac- 
ter to the LA180 printing terminal. The default is NOCTIRL. 

Ignores nonprinting control characters. This is the normal 
mode. 

Declares that the line printer has hardware form feeds, caus- 
ing the line printer handler to send form feeds to the con- 
troller. When you use this option, the line printer hardier 
sends the form feed character to the printer each time the 
handler encounters a form feed. This is the default setting. 

Causes the line printer handler to simulate hardware I'orm 
feeds by sending one or more line feeds to the printer. V^hen 
you use this setting, you must also use the LENGTH = n set- 
ting and position the paper at the top of a form (that is, at the 
page perforation) before you start to use the printer. Using 
the NOFORM condition is useful if you are using a preprinted 
form that has a nonstandard length. You must use this set- 
ting if your printer does not accommodate form feeds. FORM 
is the default setting. 

Issues a form feed before a request to print block 0: This is the 
normal mode. 

Turns off FORMO mode. The default is FORMO. 

Waits for you to make a correction if the line printer is not 
ready or becomes not ready during printing. If you expect out- 
put from the printer and the system does not respond or 
appears to be idle, check to see if the printer is powered on 
and ready to print. This is the normal mode. 
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Table 4-13: SET Device Conditions and ModiHcation (Cont.) 



Device or 
Item 



LS: 
LS: 

LS: 
LS: 

LS: 



LS: 
LS: 

LS: 



LS: 



MM: 



MM: 



MM: 



Condition 



NOHANG 
LC 

NOLC 
LENGTH=n 

SKIP=n 



TAB 
NOTAB 

VECTOR=n 



WIDTH=n 



DEFALT=9 



DENSE=[800 
or 809 
or 1600] 



ODDPAR 



Modiiication 



Generates an immediate error if the printer is not ready. The 
default setting is HANG. 

Allows the system to send lower-case characters to the printer. 
Use tliis condition if your printer has a lower-case character 
set. This is the normal mode. 

Translates lower-case characters to upper-case before printing. 
The default is LC. 

Causes the printer to use n as the number of lines per page. 
The default number of lines per page is 66. Use this option 
with the NOFORM and SKIP=n settings. 

Causes the line printer handler to send a form feed to the 
printer when it comes within n lines of the bottom of a page. 
Use this setting to prevent the printer from printing over page 
perforations. The value you supply for n should be an integer 
from to the maximum number of lines on the paper. If you 
set SKIP=0, the handler sends lines to the printer regardless of 
the position of the paper. If you have set SKIP to a value other 
than 0, set SKIP=0 to disable this condition. When you use 
this setting, you must also use the LENGTH=n setting. The 
default is SKIP=0. 

Sends TAB characters to the printer. The default is NOTAB. 

Expands TABS by sending multiple spaces to the printer. 
This is the normal mode. 

Modifies the printer handler to use n as the vector of the line 
printer controller. The value you supply for n must be an even 
octal address below 500. This option enables you to set a spe- 
cial vector value in the line printer handler itself, without 
having to modify the handler source code and reassemble. Use 
this option if you have installed the printer controller at a 
nonstandard address. 

Sets the printer to width n, where n is a decimal integer be- 
tween 30 and 255, inclusive. The system ignores any characters 
that print past column n. The default is 132. 

Returns to default settings for 9-track tape. The 9-track de- 
faults are; 

DENSE=809 

ODDPAR 

NODUMP 

Sets density for the 9-track tape handler. Do not alter the 
density setting within a volume. A density setting of 1600 bits 
per inch (BPI) automatically sets parity to odd. The valid 
density settings for 9-track tape are: 

800 BPI 
1600 BPI 

Sets parity to odd for 9-track tape. DIGITAL recommends this 
setting. 



I 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



Device or 
Item 



MM: 



MT: 



MT: 



Condition 



NOODDPAR 



DEFALT= 
or 9] 



DENSE=[200 
or 556 or 800 
or 807 
or 809] 



MT: 



MT: 
MT: 

TT: 



TT: 



TT: 



DUMP 



ODDPAR 



NOODDPAR 



CONSOL=n 



CRLF 



NOCRLF 



Modincation 



Sets parity to even for 9-track tape. DIGITAL does not recom- 
mend this setting for normal operation, and provides it only 
for compatibility with other systems. 

Returns to default settings for 7- or 9-track tape. The 7-track 
defaults are equivalent: 

DENSE=800 
ODDPAR 

Sets density for 7- or 9-track tape. Specifying 200, 556, or 807 
for 7-track tape sets 6-bit mode. Density settings 800 and 809 
are equivalent. Specifying either 800 or 809 for 7-track tape 
sets core dump mode. Settings 800 and 809 are only valid 
settings for 9-track tape. Thus, the valid density setting^ are 
as follows: 

7-track: 200 = 200 bpi six-bit mode 
556 = 556 bpi six-bit mode 
807 = 800 bpi six-bit mode 
800 or 809 = 800 bpi core dump mode 

9-track: 800 or 809 = 800 bpi 

Sets core dump mode for 7-track tape. This is equivalent to 
setting DENSE = 800 or 809. 

NOTE 

These SET command options apply to all units of the magtape 
controller. Six-bit mode and core dump mode are described in 
the RT-11 Software Support Manual. 



Sets parity to odd for 7- 
mends this setting. 



or 9-track tape. DIGITAL recom- 



Sets parity to even for 7- or 9-track tape. DIGITAL does not 
recommend this setting for normal operation, and provides it 
only for compatibility with other systems. 

Directs the system to use the terminal whose logical unit num- 
ber you specify as the console terminal. The terminal whose 
logical unit number you specify must not be currently at- 
tached by the foreground or any system job. To use this set- 
ting, you must have a multi-terminal configuration. The sys- 
tem returns to this default after a reboot. You cannot use this 
setting for a remote line. 

Issues a carriage return/line feed combination on the console 
terminal whenever you attempt to print past the right margin. 
You can change the margin with the WIDTH command. This 
is the normal mode. This setting is invalid with a non-multi- 
terminal SJ monitor. The system returns to this condition 
after a reboot. 

Takes no special action at the right margin. This setting is 
invalid with a non-multi-terminal SJ monitor. The default is 
CRLF. The system returns to that condition after a reboot. 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



Device or 
Item 



TT: 



TT: 



TT: 



TT: 



TT: 



TT: 



TT: 



TT: 



TT: 



TT: 



Condition 



FB 



NOFB 



FORM 



NOFORM 



HOLD 



NOHOLD 



PAGE 



NOPAGE 

QUIET 
NOQUIET 



Modification 



Treats CTRL/B and CTRL/F (and CTRL/X in system job mon- 
itors) as background and foreground program control charac- 
ters and does not transmit them to your program. This is the 
normal mode. This setting is not valid for the SJ monitor. The 
system returns to this condition after a reboot. 

Causesi CTRL/B and CTRL/F (and CTRL/X in system job mon- 
itors) to have no special meaning. Issue SET TT: NOFB to 
KMON, which runs as a background job, to disable all com- 
munication with the foreground or system job. To enable com- 
munication with the foreground job, issue the command SET 
TT FB. This setting is not valid for the SJ monitor. The 
default is FB. The system returns to that condition after a 
reboot. 

Indicates that the console terminal is capable of executing 
hardware form feeds. This setting is invalid with a non-multi- 
terminal SJ monitor. 

Simuhites form feeds by generating eight line feeds. This set- 
ting is not valid for the non-multi-terminal SJ monitor. This 
is the normal mode. The system returns to this condition after 
a reboot. 

Enables the Hold Screen mode of operation for the VT50, 
VT52, and VT61 terminals. The command has no effect on any 
other terminals, but it can cause a left square bracket (I) to 
print. This setting is valid for all monitors. NOHOLD is the 
default setting. The system returns to that condition after a 
reboot. 

Disables the Hold Screen mode of operation for the VT50 ter- 
minal. The command has no effect on any other terminal, but 
it can clause a backslash (\) to print. This setting is valid for all 
monitors. The default is NOHOLD. The system returns to 
that condition after a reboot. 

Treats CTRL/S and CTRL/Q characters as terminal output 
hold and unhold flags and does not transmit them to your pro- 
gram. You must use this setting if you are using a VTIOO ter- 
minal. This setting is not valid for the non-multi-terminal SJ 
monitor. This is the normal mode. The system returns to this 
condition after a reboot. 

Causes CTRL/S and CTRL/Q to have no special meaning. This 
setting is not valid for the non-multi-terminal SJ monitor. 
The default is PAGE. The system returns to that condition 
after a reboot. 

Prevents the system from echoing lines from indirect files. 
The default is NOQUIET. The system returns to that condi- 
tion after a reboot. 

Echoes lines from indirect files. This is the default mode. The 
systemi returns to this condition after a reboot. 
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Table 4-13: SET Device Conditions and Modification (Cont.) 



Device or 
Item 



Condition 



Modification 



TT: 



SCOPE 



TT: 



TT: 



TT: 



TT: 



USR 



USR 



WILD 



WILD 



NOSCOPE 



TAB 



NOTAB 



WIDTH = n 



SWAP 



NOSWAP 



EXPLICIT 



IMPLICIT 



Echoes RUBOUT characters as backspace-space-backspeice. 
Use this mode if your console terminal is a VT50, VT05, 
VT52, VT55, VT61, VTIOO, or if GT ON is in effect. The 
default is NOSCOPE. The system returns to that condition 
after a reboot. Note that you delete TAB characters by typing 
a single RUBOUT or DELETE, even though the cursor does 
not move back the correct number of spaces. This is a restiric- 
tion in SCOPE modes. 

Echoes RUBOUT characters by enclosing the deleted charac- 
ters in backslashes. This is the normal mode. The system 
returns to this condition after a reboot. 

Indicates that the console terminal is capable of executing 
hardware tabs. This setting is not valid for the non-multi-ter- 
minal SJ monitor. The default is NOTAB. The system retu:rns 
to that condition after a reboot. 

Simulates tab stops every eight positions. Many terminals 
supplied by DIGITAL have hardware tabs. This setting is not 
valid for the non-multi-terminal SJ monitor. This is the nor- 
mal mode. The system returns to this condition after a reboot. 

Sets the terminal width to n, where n is an integer between 30 
and 255. The system initially sets the width to 80. This setting 
is not valid for the non-multi-terminal SJ monitor. (See SET 
TT CRLF.) The system returns to 80 after a reboot. 

Allows the background job to place the user service routine 
(USR) in a swapping state. This setting is not valid for the XM 
monitor. This is the normal mode for FB and SJ monitors. T'he 
system returns to this condition after a reboot. 

Prevents the background job from placing the USR in a 
swapping state. This setting is not valid for the XM monitor. 
The default is SWAP for FB and SJ monitors. The system 
returns to that condition after a reboot. 

Causes the system to recognize file specifications exactly as 
you type them. If you omit a file name or a file type in a file 
specification the system does not automatically replace the 
missing item with an asterisk (*). Wildcards are described in 
Section 4.2 of this manual. The default is IMPLICIT. The sys- 
tem returns to that condition after a reboot. 

Causes the system to interpret missing fields in file specifica- 
tions as asterisks (*). Wildcards are described in Section 4.2 of 
this manual. Table 4-2 shows how the system interprets com- 
mands that have missing fields. This is the normal mode. The 
system returns to this condition after a reboot. 
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The following examples illustrate the SET command. This command allows 
the system to send lower-case characters to the printer: 

.SET LP LC 

The next command sets the system wildcard default to implicit. 

.SET m.U:i IMPLICIT 

As a result of this command the system inserts an asterisk in place of a miss- 
ing file name or file type in a file specification. See Table 4-2 for a list of 
these commands. 
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The SHOW command prints information about your RT-11 system on the 
console terminal. 







n 


(SP) 


ALL 
CONFIGURATION 




DEVICES 




ERRORS 


/ALL 

/FILErlilespec 

/FROM [:date| 

/OUTPUTifllespec 1 

/PRINTER 

/SUMMARY 

/TERMINAL 




JOBS 


/TO [:date) 




QUEUE 




[terminals J 


L 




J 



The information includes hardware configuration, monitor version, special 
features in effect, device names and logical device name assignments, termi- 
nal characteristics for terminals currently active on a multi-terminal sys- 
tem, and device handler status. If you are running the Error Loggei* or 
QUEUE, the SHOW command can provide information on errors and the 
update status of files waiting to be sent to an output device. 

If you specify SHOW without an option, SHOW displays your system's 
device assignments. The devices the system lists are those known by the 
RT-11 monitor currently running in memory. This list reflects any aiidi- 
tions or deletions you have made with the INSTALL and REMOVE com- 
mands. The listing also includes additional information about particular 
devices. The informational messages and their meanings are: 



Message 

(RESORC) 
or = RESORC 



(FORE) 
or -FORE 

(jobname) 
or =jobname 



(Loaded) 
(Resident) 



Indicated Condition 

The device or unit is assigned to the back- 
ground job RESORC (for FB and XM monitors 
only). 

The device or unit is assigned to the fare- 
ground job (for FB and XM monitors only and 
monitors without system job support). 

The device or unit is assigned to the system or 
foreground job (for FB and XM monitors t;hat 
have system job support), where jobname rep- 
resents the name of the system or foreground 
job. 

The handler for the device has been loaded 
into memory with the LOAD command. 

The handler for the device is included in the 
resident monitor. 
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= logical-device-name(l), The device or unit has been assigned the 
logical-device-name(2)... indicated logical device names with the 
,Iogical-device-name(n) ASSIGN command. 

XX free slots The last line tells the number of unassigned, 

or free, device slots. 

The following example was created under an FB monitor that has system job 
support. It shows the status of all devices known to the system. 

. SHOW 

T T (Resident) 

RK (Resident) 

RK:l. == SY> DKi. OBJir SRCi- BIN 

RK2 = LST? MAP 
MQ (Resident) 
DL (Loaded) 
DM 
nx (Loaded) 

DXO: (MYPROG) 

DX.1. ; (RESORC;) 
LP J (Loaded=^^aUEUE) 
MT 
CT 
5 free slots 

The listing shows first that TT and RK are resident in memory. The other 
device handlers known to the system are MQ, DL, DM, DX, LP, MT, and CT. 
There are five free slots in the table. RKO: has the logical names SY, DK, 
OBJ, SRC, and BIN. RKl: has the logical names LST and MAP. The DX 
handler is loaded and device DXO: belongs to the foreground job, MYPROG. 
The LP: handler is loaded and belongs to the system job, QUEUE. 

The options for the SHOW command follow. 

ALL This option is a combination of CONFIGURATION, DEVICES, 
JOBS, and TERMINALS, in that order. The ALL option also tests the device 
assignments. 

CONFIGURATION This option displays the monitor version number 
and patch level, the monitor SET options in effect, the hardware con- 
figuration, and the special features in effect (if any). The listing varies, of 
course, depending on which monitor and which hardware system you are 
using. 

First, the listing always shows the version number and patch level of the 
currently running monitor. 

Next, information about the monitor is displayed. The first line indicates the 
device from which the system was bootstrapped. The next line prints the 
resident monitor's base address, in octal. Then the listing shows whether the 
user service routine (USR) is set to SWAP or NOSWAP. Another line prints 
out if a foreground job is loaded. The listing shows whether TT is set QUIET 
or NOQUIET, and whether the indirect file abort level is set to NONE, 
WARNING, ERROR, or SEVERE. The indirect file nesting depth prints out 
as a decimal number. 
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Next, the listing displays the system hardware configuration. It lists the 
processor type, which can be one of the following: 

LSI 11 

PDT 130/150 
PDP 11/04 
PDF 11/05,10 
PDP 11/15,20 
PDP 11/23 
PDP 11/34 
PDP 11/35,40 
PDP 11/45,50,55 
PDP 11/60 
PDP 11/70 

A separate line prints out for each of the following items that is present on 
your system: 

FPU Hardware Floating Point Unit 
Commercial Instruction Set (CIS) 
Extended Instruction Set (EIS) 
Floating Instruction Set (FIS) 
KTll Memory Management Unit 
Parity Memory 
Cache Memory 

If you have graphics hardware (VTll or VS60), another line is printed out to 
indicate it. The clock frequency (50 or 60 cycles) prints next, followed by a 
line for the KWll-P programmable clock, if there is one on your system. 

Finally, the listing either shows that there are no special features in efliect, 
or it lists the appropriate features from the following list: 

Device I/O time-out support 
Error logging support 
Multi-terminal support 
Memory parity support 
SJ timer support 
System job support 

The following example was created on a PDP 11/23 processor: 

.SHOW (:;onf:i:guratton 

RT-:l.:I.FB(S) V04.00 

Booted from RKOS 

Resident Mon:Ltor base is :l.37500 (48960.) 

USR is set SWAP 

TT is set NOQUTET 

Indirect file abort i evel is ERROR 

:i:ndirect fiie nest ins! depth is 3 

PDP :L:I./23 

<i)0 Cade System Clock 

frrror .losf.v.fin.'.-f support jm^ 

Device :i:/0 time -out support •'"^ 

Memory parity support 
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DEVICES This option displays the RT-11 device handlers, their status, 
and their vectors. The messages for handler status are as follows: 

Installed 

Not installed 

-Not installed (the handler special features do not match those of the 

monitor) 

nnnnnn (load address of hand] er) 

Resident 

The following example uses SHOW DEVICES. 



.SHOW 


DEMICES 




Dev:i,c 


s Status 


Vector 


»X 


Ins tail, led 


264 


RK 


Resident 


220 


Rl" 


Not installed 


204 


DT 


Installed 


214 


LP 


Installed 


200 


CR 


Not installed 


230 


NL 


Installed 


000 


PC 


Installed 


070 074 


cr 


Installed 


260 


riii) 


Installed 


204 


rifi 


Installed 


210 


Dl... 


Installed 


330 


DF' 


Installed 


254 


DY 


Installed 


270 


MT 


Installed 


224 



MM Not installed 224 

In the preceding example, note that the PC handler has two vectors. One is 
for the paper tape reader and the other is for the paper tape punch. Because 
of its special format, the TT handler is never listed. 

JOBS This option displays data about the jobs that are currently loaded. 
This option also tells the following: 

• the job name and number (if you have not enabled system job support on 
your monitor, the foreground job name appears as FORE, and its priority 

isl) 

• the console the job owns (if a non-multi-terminal monitor, this space is 
blank) 

• thepriority level of the job 

• the job's running state (running, suspended, or done (but not unloaded)) 

• the low and high memory limits of the job 

• the start address of the job s impure area 
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The example that follows displays data about currently running jobs: 



;how JOEis 



Job 


Name ( 


;onso:i.e 


Level 


State 


Low 


Hisfh 


Tni>-i..n~e 


14 


aUEUE 





6 


Susrei 


id :l. 1.6224 


:L 30306 


1.:L5254 





RESORC; 








Run 


000000 


1:1.5 2:1.0 


:l. 3 4:1. 2 6 



ERRORS The SHOW ERRORS command is valid only if you have error 
logging enabled on your monitor. For a complete description of the error log- 
ger and directions on how to start it, see Chapter 19, Error Logging. >[ote 
that the error logger is a special feature, available only through the system 
generation process. Because the error logger compiles statistics on each I/O 
transfer that occurs, in addition to hardware errors that occur, it is a gfood 
idea to enable error logging on a spare system volume that you use only 
when you want to compile error statistics. 

The SHOW ERROR command invokes ERROUT, one of the three programs 
in the error logging package that runs as a background job. ERROUT cre- 
ates reports on the I/O and error statistics the error logger compiles, and can 
print the reports at the terminal, line printer, or store the reports in a file 
you specify. For complete descriptions of the reports ERROUT creates, see 
Chapter 19, Error Logging. 



ERRORS <RET> 



ERRORS/ALL 
ERRORS/FILE:filespec 



ERRORS/FROM[:date] 



ERRORS/TO[:date] 



ERRORS/OUTPUT:filespec 



prints a full report on each I/O transfer that 
has occurred in addition to each I/O, memory 
parity, and cache memory error that has 
occurred. 

same as SHOW ERRORS <RET> 

prints a full I/O transfer and error report from 
the file you specify. The file you specify must 
be of the same format that the error logger 
uses for its statistics compilations. 

prints a full I/O transfer and error reporl; for 
errors that occurred starting from the (iate 
you specify. Enter the date as dd:mmm:yy, 
where 

dd is a two-digit date (decimal) 

mmm is the first three characters of a month 

yy is a two-digit year 

prints a full I/O transfer and error report for 
errors that occurred up to the date you 
specify. 

enters the I/O transfer and error report ini the 
output file you specify. This is useful if you 
want to save the error logging reports. 
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Rim 



■PHP 



SHOW 

prints the I/O transfer and error report at the 
line printer. 

prints a summary error report at the termi- 
nal. The summary error report lists only the 
errors that occurred, not the successful I/O 
transfers. 

prints the I/O transfer and error report at the 
terminal. /TERMINAL is the default setting. 

QUEUE Use the SHOW QUEUE command to get a listing of the contents 
of the queue. This option is invalid if you are not running QUEUE (see 
Chapter 20, Queue Package). The listing shows the output device, job name, 
input files, job status, and number of copies for each job that is queued. The 
sample command line that follows lists the current contents of the queue. 



ERRORS/PRINTER 



ERRORS/SUMMARY 



ERRORS/TERMINAL 



.SHOW 


QUI:: 


:uE 




i:iEv:i:cc: 




JOB : 


BTA 


i...F'0 : 




I...AB2 


F 


I...PO ; 




HODG 


Q 


DTK 




juririH 


a 


MTJ, ; 




SZYH 


Q 


Lpo; 




JOYCE 


« 



cop:i:e 



FILES 

PASS3 .LST 
PABS4 . 1... SI- 
PA SS5 .LST 
MESMAN.DOC 
PART:l. .DOC 
PAIa'TS . DOC 
REFMAN.TXT 



SH 



. DOC 



:l. D0CPLN.DOC 

The job STATUS column prints a P if the job is currently being output, an S 
if the job being output is suspended, or a Q if the job is waiting to be output. 
If you have a large lineup of files, and your console is a video terminal, you 
can use the CTRL/S and CTElL/Q commands to control the scrolling of the 
listing. 

TERMINALS This option indicates the status of and special features in 
effect for currently active terminals on multi-terminal systems. If your sys- 
tem, has only the console terminal, the following message prints: 

No nii..ilt:L--teriri:i.n<ii:t support 

Multi-terminal support is a sijecial feature; it is not part of the distributed 
RT-11 monitors. 

If your system does have multi-terminal support, SHOW TERMINALS 
prints a table of the existing terminals and lists the following information: 

Unit number (0-15) 

Owner: Background, foreground, system job owner, or none 

Type: Local 

Remote (dial-up) 



Console 



(continued on next page) 
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Unit number (0-15) 

S-console (shared by background and foreground or sys- 
tem job) 
Is attached to another job (the foreground) 

Interface type: DL DZ 

Width: (width in characters, up to 255) 

SET options in effect: 

TAB 
CRLF 
FORM 
SCOPE 

Line speed: (baud rate if DZ; not applicable if DL) 

The following example shows the terminal status of an RT-11 system. 

.3H0U) TERMINALS 

Unit Owner Type WIDTH TAB CRLF FORM SCOPE SPEEn 

RESORC S-Console DL 132 No Yes No No N/A 
;l FORE Local DL 80 Yes No No Yes N/A 
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The SQUEEZE command consolidates all unused blocks into a single area on 
the device you specify and consolidates the directory entries on the device. 




In the command syntax illustrated above, device represents the block replace- 
able volume to be compressed. To perform a squeeze operation, the system 
moves all the files to the bepnning of the device you specify, producing a 
single unused area after the group of files. The squeeze operation does not 
change the bootstrap blocks of a device. The system prints a confirmation 
message before it performs the squeeze operation. You must type Y followed 
by a carriage return to execute the command. 

The squeeze operation does not move files with .BAD file types. This feature 
prevents you from reusing bad blocks that occur on a disk. During a squeeze 
operation, files with a .BAD file type will be renamed FILE.BAD. The system 
inserts files before and after .BAD files until the space between the last file it 
moved and the .BAD file is smaller than the next file to be moved. Note that 
you should use the SQUEEZED command when you get a directory full error, 
even if there is still space remaining on the volume. 

If you perform a squeeze operation on the system device, the system automati- 
cally reboots the running monitor when the compress operation completes. 
This reboot takes place in order to prevent system crashes that might occur 
when the monitor file or handler files are moved. The system volume cannot 
be squeezed if a foreground or system job is loaded. 

The options for the SQUEEZE command follow. 

/OUTPUT :filespec Use this option to transfer all the files from the input 
device to the output device in compressed format, an operation that leaves the 
input device unchanged. The output device must be an initialized block re- 
placeable volume. (Use the INITIALIZE command to do this.) Note that the 
system does not query you for confirmation before this operation proceeds. If 
the output device is not initialized, the system prints an error message and 
does not execute the command. Note that /OUTPUT does not copy boot 
blocks; you must use the COPY/BOOT command to make the output volume 
bootable. The following example transfers all the files from RKO: to RKl: in 
compressed format, leaving RKO: unchanged. 

. S (S U K: E Z E / U T P IJ T J R K :l. J R K : 

/QUERY This option causes the system to print a confirmation message 
before it executes a squeeze operation. You must respond by typing a Y 
followed by a carriage return for execution to proceed. This is the default 
operation. /QUERY is invalid with the /OUTPUT option. 
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/NOQUERY Use this option to suppress the confirmation message thiat 
prints before a squeeze operation executes. The following command com- 
presses all the files on device DTI: and does not query. 

. S(;n.)E:E2;E/N0«UERY dtu 

/WAIT This option is useful if you have a single-disk system. When you 
use /WAIT, the system initiates the SQUEEZE operation, but then pauises 
and waits for you to mount the volume you want to squeeze. When the sys- 
tem pauses, it prints Mount input volume in <device>; Continue'?, where 
<device> represents the device into which you mount the volume. When t;he 
volume is mounted, type Y followed by a carriage return. 

The following sample command line squeezes an RK05 disk: 

.SQUEEZE/WAIT RKO: 

RKOJ/S(sueez<:^J Are hdu sure?? Y 

Mount input voluitie? in RKO 5 J Continue? Y 

M o I..1 1 1 1 <s H s t €^ lYi V o :i. I..I m e i n R KO : » Co n t i ri u e ? Y 

Note that the system may repeat the Mount input volume — Mount output 
volume cycle several times to complete the SQUEEZE operation. 
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The SRUN command initiates system jobs. 



SRUNI ( SP ) lilespec 


/BUFFER:n 

/LEVELin 

/NAME:logical-jobname 

/PAUSE 

/TERM[NAL;n 





In the command syntax illustrated above, filespec represents the program to 
be executed. Because this command runs a system job, it is valid only for FB 
and XM monitors that have system job support — a special feature enabled 
through the system generation ])rocess. 

You can run up to six system jobs simultaneously, in addition to the fore- 
ground and background jobs. If you attempt to run a system job that is 
already active, an error messag<i prints on the terminal. 

Note that when you issue the SRUN command, the monitor assumes a .SYS 
file type. If you want to issue the SRUN command for a program that has a 
.REL file type, either enter the; file type with the file name (for example, 
SRUN QUEUE.REL), or rename the file so it has a .SYS file type. 

In an XM monitor, you can use the SRUN command to run a virtual .SAV 
imag(5 program. You must type the file type explicitly. 

The options that you can use with SRUN follow. 

/BUFFER:n Use this option to reserve space in memory over the actual 
program size. The argument n represents the number of octal words of mem- 
ory to allocate. You must use this option to run any FORTRAN program as a 
system job. If you use this option for a virtual job linked with the /V option 
(or /XM), the system ignores /BUFFER because the system provides a buffer 
in extended memory. 

/LEVEL:n Use this option to assign an execution priority level to the job, 
where n can be 1, 2, 3, 4, 5, or 6. If you attempt to assign the same priority 
level to two system jobs, an error message prints at the terminal. If omitted, 
the priority level defaults to the highest level that is thus far unassigned. 

/NAMEiIogical-jobname Use this option to assign a logical job name to a 
program. This is the name that programmed requests and SYSLIB calls use 
to reference a system job. If you attempt to assign the same logical job name 
to two system jobs, an error message prints at the terminal. If you do not 
specify a logical job name, the system assumes the file name of the program. 

/PAtrSE Use this option to heslp you debug a program. When you type the 
carriage return as the end of the; command string, the system prints the load 
address of your program and waits. By means of ODT, you can examine or 
modify the program before starting execution (see Chapter 21). You must 
use the RESUME command to restart the system job. The following com- 
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mand loads the program MFUNCT.SYS, prints the load address, and vmits ji||. 

for a RESUME command to begin execution. ■ 

.SRUN MFUNCT/PAUBE 
Loaded at 1.265SA 
.RESUME MFUNCr 

/TERMINALrn Use this option to change the console of the system job. 
Your system must have multi-terminal support — a special feature avail- 
able only through system generation — before you can use it. The argument 
n represents a terminal logical unit number. By assigning a different termi- 
nal to interact with the system job, you eliminate the need for system, fore- 
ground, and background jobs to share the console terminal. Note that the 
original console terminal still interacts with the background job and with 
the keyboard monitor, unless you use the SET TT: CONSOL command to 
change this. 
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START 

The START command initiates execution of the program currently in mem- 
ory (loaded with the GET command) at the address you specify. 



r ( SP ) address 



In the command syntax shown above, address is an even octal number rep- 
resenting any 16-bit address. If you omit the address or if you specify 0, the 
system uses the starting address that is in location 40. If the address you 
specify does not exist or is invfilid for any reason, a trap to location 4 occurs 
and the monitor prints an error message. Note that this command is valid 
for background jobs only, and not for extended memory virtual jobs. The fol- 
lowing command loads MYPROG.SAV into memory and begins execution. 

. GET HYPROO 
.START 

The next example loads MYPROG.SAV and ODT.SAV into memory, and 
begins execution at ODT's starting address. 

.GET MYPR06 
,GET ODT 
, START :l.222 
OUT vol. .0^ 
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The SUSPEND command temporarily stops execution of the foregrounid or 
system job. 



SP ) jobname 



If you have system job support enabled on your monitor, specify the name of 
the system or foreground job you wisTi to suspend. If you do not have system 
job support, then do not include an argument with the SUSPEND command. 
The SUSPEND command is not valid for the SJ monitor. The system per- 
mits foreground input and output that are already in progress to finish; how- 
ever, it issues no new input or output requests and enters no completion 
routines (see the RT-11 Programmer's Reference Manual for a detedled 
explanation of completion routines). You can continue execution of the; job 
by typing the RESUME command. The following command suspends execu- 
tion of the foreground job that is currently running on a system that does not 
have system job support. 

.SUSPEND 

The next command suspends execution of the system job, QUEUE, that is 
currently running on a system that does have system job support. 

.SUSPEND QUEUIi- 
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Use the TIME command to set the time of day or to display the current time 
of day. 



:CiD 



TIME K SP ) hh:mm:ss 



In the command syntax shown above, hh represents hours (from to 23); mm 
represents minutes (from to 59) and ss represents seconds (from to 59). 
The system keeps time on a 24-hour clock. 

To enter the time of day, specify the time in the format described above. You 
should do this as soon as you bootstrap the system. The following example 
enters the time, 11:15:00 A.M. 



.TiMi;:: iitv 



As this example shows, if you omit one of the arguments the system 
assumes 0. 

To display the current time of day, type the TIME command without an 
argument, as this example shows. 

<.t:i:me 
1 :i. n5:o:i. 

When you install the standard RT-11 monitors, the clock rate is preset to 60 
cycles. Consult the RT-11 Installation and System Generation Guide for in- 
formation on setting the clock to a 50-cycle rate. 

The FB and XM monitors automatically reset the time each day at midnight 
when a TIME command is used, or if a .GTIM programmed request is issued. 
(The TIME command issues a .GTIM programmed request.) The SJ monitor 
resets the time under these conditions only if you select timer support during 
the system generation process. 
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TYPE 

The TYPE command prints the contents of one or more files on the terminal. 



TYPE 


IcOPIE&n 
/DELETE 
/(NO] LOG 
(NEWFILES 
/QUERY 


( SP ) filespocs 




/WAIT 





In the command syntax illustrated above, filespecs represents the file or files 
to be typed. You can explicitly specify up to six files as input to the TYPE 
command. The system types the files in the order in which you specify them 
in the command line. You can also use wildcards in the file specification. In 
this case, the system types the files in the order in which they occur in the 
directory of the device you specify. If you specify more than one file, separate 
the files by commas. If you omit the file type for a file specification, the sys- 
tem assumes .LST. You can specify the entire command on one line, or you 
can rely on the system to prompt you for information. The TYPE command 
prompt is Files?. 

The TYPE command options and examples follow. 

/COFIESrn Use this option to list more than one copy of the file. The 
meaningful range of values for the decimal argument n is from 2 to 32 (1 is 
the default). The following command, for example, types three copies of the 
file REPORT.LST on the terminal. 

, T Y P E / C F> 3: E S : 3 R E P C) R T 

/DELETE Use this option to delete a file after it is typed on the terminal. 
This option must appear following the command in the command line. The 
TYPE/DELETE operation does not ask you for confirmation before it exe- 
cutes. You must use /QUERY for this function. The following example types 
a BASIC program on the terminal, then deletes it from DXl:. 

. TYPE/DELETE DXl rPROGl ,BAS 

/LOG This option prints on the terminal the names of the files that were 
typed by the current command. Normally, the system prints a log only if 
there is a wildcard in the file specification. If you specify /QUERY, the query 
messages replace the log, unless you specifically type /LOG/QUERY in the 
command line. The following example shows a TYPE command and the 
resulting log. 

. rYPE/LDG OUTF:n....l..ST 
Files copied* 
DKJOUTFitL.LSr to tt: 

/NOLOG This option prevents a list of the copied files from printing on the 
terminal. You can use this option to suppress the log if you use a wildcard in 
the file specification. 
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/NEWFILES Use this option in the command line if you need to type only 
those files that have the current date. The following example shows a con- 
venient way to type all new files after a session at the computer. 

, type/newf:i:lee> *.Lsr 

Files copied? 

riK: REPORT. I..ST to tt: 

/QUERY If you use this option, the system requests confirmation 
before it performs the operation. /QUERY is particularly useful on oper- 
ations that involve wildcards, when you may not be sure which files the sys- 
tem selected for an operation. Note that if you specify /QUERY in a TYPE 
command line that also contains a wildcard in the file specification, the con- 
firmation messages printed on the terminal replace the log messages that 
would normally appea You must respond to a query message by typing Y 
(or anything that begins with y) and a carriage retun to initiate execution 
of a articular operation. The system interprets ay other response to mean 
NO and does not perform the specific operation. 

. TYPE/QUERY/DELETE * . LSI 
F i :i. es COP i ed/de 1 eted S 

»k;outf:i:i....lbt to ttj? no 

i:iK 5 REPORT. LSI to TTJ? Y 

/WAIT This option is useful if you have a single-disk system. When you 
use this option, the system initiates the TYPE operation, but then pauses 
and waits for you to mount the volume on which you want the operation to 
take place. When the system pauses, it prints Mount input volume in 
<device>; Continue? , where <device> represents the device into which you 
mount the volume. When you have mounted the volume, type Y followed by 
a carriage return. 

The following sample command types AJAX.DOC from an RK05 disk: 

. TYPE/WA :i: T RKO t AJ AX . HOC 

Mount input volume in RKO I 5 ContinueTY 

After the system has typed AtFAX.DOC at the terminal, it issues the follow- 
ing prompt: 

Mount sHsteiii volume in RKO'P Continue? 

When you mount the system volume, and type a Y followed by a carriage 
ret\irn, you terminate the TYPE operation. 



Keyboard Commands 4-175 



UNLOAD 

The UNLOAD command removes previously loaded handlers from memory, 
thus freeing the memory space they occupied. It also removes termiiiiated 
foreground or system jobs. 



UNLOAD 


device [,. . .device] 
jobname [,. . .jobname] 





In the command syntax shown above, device represents the device handler 
to be unloaded. The colon that follows the device handler is optional witli SJ, 
FB, and XM monitors and monitors that do not have system job support. 
You must include the colon if your system has system job support. 

UNLOAD clears ownership for all units of the device type you speciiy. A 
request to unload the system device handler clears ownership for any 
assigned units for that device, but the handler itself remains resident, i^ifter 
you issue the UNLOAD command, the system returns any memory it frees 
to a free memory list. The background job eventually reclaims free memory. 
Note that if you interrupt an operation that involves magtapes or cassette, 
you must unload and then load (with the LOAD command) the appropiriate 
device handler (MM, MT, MS, or CT). 

The system does not accept an UNLOAD command while a foreground job is 
running if the foreground job owns any units of that device. This is because a 
handler that the foreground job needs might become nonresident. You can 
unload a device while a foreground job is running if none of its units belong 
to the foreground job. 

A special function of this command is to remove a terminated foreground or 
system job and reclaim memory, since the system does not automatically 
return the space occupied by the foreground or system job to the free mem- 
ory list. The following command unloads the foreground job and freesi the 
memory it occupied. This command is valid only if the foreground job is not 
running. 

•UNLOAD F 

The following command unloads the system job QUEUE. 

.UNLOAD QUEUE 

The following command clears ownership of all units of RK:. If RK: is the 
system device, the RK handler itself remains resident. 

.UNLOAD RK; 

The next command releases the line printer and DECtape handlers and 
frees the area they previously held. 

.UNLOAD LP: rDTJ 
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Table 5-1: EDIT Key Commands (Cont.) 



Key 



CT'RL/C 



Explanation 



CTRL/0 



CTRLAJ 



RUBOUT 

or 
DELETE 



TAB 



CTRL/X 



In the first command, the three CTRL/C characters are part of the text 
object of the Insert command. EDIT treats them hke any other character. In 
the second command string, the CTRL/C occurs at command level, which 
causes the editor to terminate. 

If no commands (other than CLOSE) are executed between the time you 
terminate the editor and the time you issue a REENTER command, the 
text buffer is preserved as it was at program termination. However, only the 
text buffer is preserved. The input and output files are closed, and the save 
and macro buffers are reinitialized. 

If you inadvertently terminate an editing session before the output file can 
be closed, you can often use the monitor CLOSE command to make perma- 
nent the portion of the output file that has already been written (see Section 
4.4). You can then reenter the editor, open a new output file, and continue 
the editing session. 

Echoes as 'O and a carriage return. Inhibits printing on the terminal until 
completion of the current command string. Typing a second CTRL/0 
resumes output. 

Echoes as 'U and a carriage return. Deletes all characters on the current 
terminal input line. (Typing CTRL/U has the same effect as pressing the 
RUBOUT key until all the characters back to the beginning of the line are 
deleted.) 

Deletes a character from the current command line; echoes as a backslash 
followed by the character deleted. Each succeeding RUBOUT you type 
deletes and echoes ajiother character. An enclosing backslash prints when 
you type a key other than RUBOUT. This erasure is done from right to left. 
Since EDIT accepts multiple-line commands, RUBOUT can delete past the 
carriage returnAine feed combination and delete characters on the previous 
line. You can use RUBOUT in both command and text modes. 

Spaces to the next tap stop. Tab stops are positioned every eight spaces on 
the terminal; pressing the TAB key causes the carriage to advance to the 
next tab position. 

Echoes as "X and a carriage return. CTRL/X causes the editor to ignore the 
entire command string you are currently entering. The editor prints a car- 
riage return/line feed combination and an asterisk to indicate that you can 
enter another command. For example: 

»IABCD 
EFGH'X 
* 

A CTRL/U would cause only deletion of EFGH; CTRL/X erases the entire 
command. 

If you are runnini? a system job, you must SET TT:NOFB to enable this 
function of CTRL/X. If you do not and you type CTRL/X, the system inter- 
cepts the CTRL/X and prompts you for a system job name. 
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5.4 Command Structure 



EDIT commands fall into eight general categories. Table 5-2 lists these cate- 
gories, the commands they include, and the sections of this manual where you 
will find information on the particular command. 





Table 5-2: EDIT Command Categories 




Category 


Commands 


Section 




File open and close 










Edit Backup 


5.6.1.3 






Edit Read 


5.6.1.1 






Edit Write 


5.6.1.2 






End File 


5.6.1.4 




File input/output 










EXit 


5.6.2.4 






Next 


5.6.2.3 






Read 


5.6.2.1 






Write 


5.6.2.2 




Immediate mode 










ESCAPE 


5.7.2 






CTRLD 


5.7.2 






CTRLG 


5.7.2 






CTRLN 


5.7.2 






CTRLV 


5.7.2 






RUBOUT 


5.7.2 




Pointer location 










Advance 


5.6.3.3 






Beginning 


5.6.3.1 






Jump 


5.6.3.2 




Search 










Find 


5.6.4.2 






Get 


5.6.4.1 






Position 


5.6.4.3 




Text listing 










List 


5.6.5.1 






Verify 


5.6.5.2 




Text modification 










Change 


5.6.6.4 






Delete 


5.6.6.2 






eXchange 


5.6.6.5 






Insert 


5.6.6.1 






Kill 


5.6.6.3 




Utility 










Edit Console 


5.7.1 






Edit Display 


5.7.1 






Edit Lower 


5.6.7.6 






Edit Upper 


5.6.7.6 






Edit Version 


5,6.7.5 






Execute Macro 


5.6.7.4 






Macro 


5.6.7.3 






Save 


5.6.7.1 


_ 




Unsave 


5.6.7.2 
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to specify a special procedure for tape handling during cassette operations 
with PIP. The following operations are valid for use with cassettes: /A, /B, /C, 
/D, /G, /M, /P, /Q, /R, /S, /U, /W, and /Y. The following options are invalid 
with cassettes: /K, /N, /O, /R, .^T, /Z, and /T. If you omit the /M:n option in a 
cassette operation, the cassette rewinds before each operation (using /M:0 has 
the same effect). The character, n in /M:n, represents a count of the number 
of files from the present position on the cassette. Note that the /M:n option 
has a different meaning for magtape (Section 7.2.1.2 describes how to use 
/M:n with magtape). 

In copying from cassettes, /M:n functions as follows: 

1. If n is 0: 

The cassette rewinds and PIP searches for the file you specify. If you 
specify more than one file, or if you use a wildcard in the file specification, 
the cassette rewinds before PIP searches for each file. 

2. If n is a positive integer: 

PIP starts from the cassette's present position and searches for the file you 
specify. If PIP does not find the file by the time it reaches the nth. file from 
its starting position, it uses the nth file for the read operation. Note that if 
PIP's starting position is not the beginning of the cassette, it is possible 
that PIP will not find the file you specify, even though it does exist on the 
tape. 

3. If n is a negative integer: 

The cassette rewinds, then PIP follows the procedure outlined in step 2 
above. 

In writing to cassettes, /M:n functions as follows: 

1. If n is 0: 

The cassette rewinds and PIP writes the file you specify starting at the 
logical end-of-tape (LEOT) position. PIP deletes any file it finds along the 
way that has the same name and file type as the file you specify. 

2. If n is a positive integer: 

PIP starts from the cassette's present position and searches n files ahead, 
deleting along the way any file it finds that has the same name and file 
type as the file you specify. If it does not reach LEOT before it reaches the 
nth file from its starting position, it enters the file you specify over the nth 
file and deletes any files beyond it on the tape. If PIP reaches LEOT 
before it reaches the nth file, it writes the file you specify at the end-of- 
tape. 

3. If n is a negative integer: 

The cassette rewinds, then PIP follows the procedure outlined in step 2 
above. 
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If you are copying a file to cassette and reach the physical end-of-tape before 
the copy completes, PIP automatically continues the file on another cassestte. 
The cassette device handler prints the CTn: PUSH REWIND OR MOUNT 
NEW VOLUME message. If you want to halt the copy operation at this 
point, push the cassette rewind button. The tape rewinds, PIP printsi an 
error message, and then prompts you for a new command. However, if you 
want to continue the file on another cassette, remove the first cassette and 
put another initialized cassette in its place. The new cassette rewinds imme- 
diately. PIP then continues copying the file. The continued part of the file 
has the same file name and file type as the first part of the file, but PIP adds 
one to its sequence number to show that it is a continued file. Make sure you 
have a supply of initialized cassettes handy for cassette copy operations; you 
cannot interrupt the copy operation to initialize a cassette when PIP is wait- 
ing for a new volume. The following example shows a copy operation t;hat 
fills one cassette and continues to another. 



*CT.1. ;*,*^:=RK:Fk'T*.S 


rSylXX.SYS/Y/U/MU 


Files CDF 


'iedJ 






RK:Fi:T:l,:l.sJ. 


SYS 


to 


CT:L:RTl.tSJ.SYS 


CTi: f-'USH 


REw:i:Nri or mount nkw volume 


rk:rti.i.fei, 


SYS 


■bo 


cT:i. :Rri.:i.rB.SYS 


RK : DT . SYS 




to 


CTI. tor. SYS 


RK 5 DP . SYS 




to 


ct:l;i:ip,sys 


rk:dx.sys 




to 


CT:i:rix.sYs 


RK : RF- . SYB 




to 


CT:i. :rf-',sys 


RKiRK.SYS 




to 


CT:LSRK.SYS 


RKJIiM.SYS 




to 


CTI : DM. SYS 


RK JDS, SYS 




to 


CTI JDS. SYS 


RKJTT.SYS 




to 


ctj.:tt.sys 


RK 5 LP. SYS 




to 


qt:i. :lp.sys 


RK : CR . SYS 




to 


CTi:CR.SYS 


RK : MT . SYS 




to 


CT:l. 5MT.SYS 


RK : MM . SYS 




to 


CTI ; MM. SYS 


rk:ni...sys 




to 


CTIJNL.SYS 


RKJPC.SYS 




to 


ct:i.:pc.sys 


RK5CT.SYS 




to 


CTI. tCT.SYS 


RKJBA.SYS 




to 


CT:l. SBA.SYS 



A directory listing of the second cassette shows that the first file, 
RKMNFB.SYS, is continued from a previous tape. (The number of blocks in 
a cassette directory listing is not meaningful; it really represents the toteil of 
sequence numbers in the directory.) 



.i:i:i:rectory 


CTI. ; 














15~Ar^r--79 
















RTllFB.SYS 


.1. 


15 


-Apr 


-79 


»T 


.SYS 





DP . SYS 





15 


-Apr- 


-79 


DX 


.SYS 





RF .SYS 





15 


-Apr- 


-79 


RK 


.SYS 





DM . SYS 





IS- 


-Apr- 


-79 


D<!> 


. SYS 





TT .SYS 





IS- 


■Apr- 


-79 


LP 


.SYS 





CR . SYS 





IS 


-Apr 


-79 


MT 


. SYS 





MM .SYS 





IS- 


-Apr- 


■79 


NL 


.SYS 





PC .SYS 





IS- 


-Apr- 


-79 


i;i:L 


.SYS 





CT . SYS 





IS- 


-Apr- 


-79 


BA 


. SYS 





18 Files y 


J. Blo( 


-ks 













-Apr 

-Apt 

"Apr 

-Apt 

-Ai- 

-Apr 

"Apr 

"Ar 

"Apr 



79 

79 

79 

79 

79 

79 

--"79 
-"79 
79 
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1. If the file sequence numbesr is greater than the current position, PIP 
searches the tape in the forward direction. 

2. If the file sequence number is more than one file before the current posi- 
tion, or if the file sequence number is less than five files from the begin- 
ning-of-tape (BOT), the tape rewinds before PIP begins its search. 

3. If the file sequence number is at the current position, or if it is one file past 
the current position, PIP searches the tape in the reverse direction. 

Whenever you fetch or load a new copy of the magtape handler, the tape 
position information is lost. The "new" handler searches backward until it 
locates either BOT or a label from which it can learn the position of the tape. 
It then operates normally, according to steps 1, 2, and 3 described above. 

If you omit the /M:n option, the tape rewinds between each operation. Using 
/M:0 has the same effect as omitting /M:n. When n is positive, it represents 
the file sequence number. When n is negative, it represents an instruction to 
the raagtape handler. 

In copying from magtapes, /M:n functions as follows: 

1. If n is 0: 

The tape rewinds and PIP searches for the file you specify. If you specify 
more than one file, the tape rewinds before each search. If the file specifi- 
cation contains a wildcard, the tape rewinds only once and then PIP 
copies all the appropriate files. 

2. If n. is a positive integer: 

PIP goes to file sequence number n. If the file it finds there is the one you 
specify, PIP copies it. Otherwise, PIP prints the ?PIP-F-File not found 
message. If you use a wildcard in the file specification, PIP goes to file 
sequence number n and then begins to search for matching files. 

3. If n is -1: 

PIP starts the search at the current position. If the current position is not 
the beginning of the tape, PIP may not find the file you specify, even 
though it does exist on the tape. 

In writing to magtapes, /M:n functions as follows: 

1. If n is 0: 

The tape rewinds before PIP copies each file. PIP prints a warning mes- 
sage if it finds a file with the same name and file type as the input file and 
does not perform the copy operation. 

2. If n. is a positive integer: 

PIP goes to the file sequence number n and enters the file you specify. If 
PIP reaches logical end-of-tape (LEOT) before it finds file sequence num- 
ber n, it prints the ?PIP-F-File sequence number not found message. If 
you specify more than one file or if you use a wildcard in the file speci- 
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fication, the tape does not rewind before PIP writes each file, anci PIP 
does not check for duplicate file names. 

3. Ifnis-1: 

PIP goes to the LEOT and enters the file you specify. It does not re\vind, 
and it does not check for duplicate file names. 

4. Ifreis-2: 

The tape rewinds between each copy operation. PIP enters the file at 
LEOT or at the first occurrence of a duplicate file name. 

If PIP reaches the physical end-of-tape before it completes a copy operation, 
it cannot continue the file on another tape volume. Instead, it deletes the 
partial file by backspacing and writing a logical end-of-tape over the file's 
header label. You must restart the operation and use another magtape. 

If you type consecutive CTRL/Cs during any output operation to magtape, 
PIP does not write a logical end-of-tape at the end of the data. Consequently, 
you cannot transfer any more data to the tape unless you follow one of the 
following recovery procedures. 

1. Transfer all good files from the interrupted tape to another tape and 
initialize the interrupted tape in the following manner: 

*devl ; * . *-=devO J * . * 
"C 

*devO;/Z/Y 

2. Determine the sequential number of the file that was interrupted and 
use the /M:n construction to enter a replacement file (either a new file or 
a dummy) over the interrupted file. PIP writes the replacement file and 
a good LEOT after it. The following example assumes the bad file is the 
fourth file on the tape: 

*devO 5 r i 1 e 4 new/M i ■1-~f 1 1 e . dum 

7.2.2 Copy Operations 

PIP copies files in image, ASCII, and binary format. Other options let you 
change the date on the files, access .SYS files, combine files, and perform 
other similar operations. PIP automatically allocates the correct amount of 
space for new files in copy operations (except for concatenation). For block- 
replaceable devices, PIP stores the new file in the first empty space large 
enough to accommodate it. If an error occurs during a copy operation, PIP 
prints a warning message, stops the copy operation, and prompts you for 
another command. You cannot copy .BAD files unless you specifically type 
each file name and file type. 

7.2.2.1 Image Mode - If you enter a command line without an option. PIP 
copies files onto the destination device in image mode. Note that you cannot 
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block on either the input or output volume, it prints an error message. How- 
ever, it retries the operation and performs the copy one block at a time. If only 
one error message prints, you can assume that the transfer completed cor- 
rectly. 

Qualifiers to the fl option let you: 

1. Specify the blocks to be read from the input device and a starting block 
number for the write operation on the output device. 

2. Copy a file to a device, or a device to a file, by specifying a file name with 
either the input or output device. For example, you can copy a diskette to 
an RLOl as a file, or a file on an RK05 to a diskette. 



NOTE 

When you use /F and you have specified a magtape or cassette 
as the input device, you must specify an input file name. 

The syntax of the command is: 

output-device: ^filename \ [/G:rn]=input-device[filename]/I[/G:rn/E:rn][/F][/H] 
( A ) 



where: 

filename represents the output file name of the input device, or (when 
specified with the input device) represents the input file 
name you are copying to the output device. If you specify an 
input file, use the dummy file name A with the output speci- 
fication. Note that you can use a file name with either the 
input or output, but never with both 

A represents a dummy file name (required if the output device 

is not a magtape or cassette). Note that either filename or A, 
but not both, can be specified with the output device 

/G:rn when specified with the output device, represents the start- 

ing block number for the write operation. When specified 
with the input device, it represents the starting block num- 
ber of the read operation 

/E:rn represents the ending block number on the input device for 

the read operation 

/F indicates that a file is involved in the transfer 

/H verifies that the input matches the output 

The command string must include an input and an output specification; 
there is no default device. The fl operation does not copy to or from a device 
that has logical bad blocks. (Physical bad blocks can be logically replaced or 
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covered, as Sections 8.2.12.3 and 8.2.12.4 describe.) If one device is smaller 
than the other, DUP copies only the number of blocks of the smaller device. 

You can copy blocks between disk and magtape. DUP stores the data on the 
tape, formatting it in IK-word blocks. It is possible to store only one disk 
image on a magtape, regardless of the size of the tape. 

You can use the /H option with fl to verify that the input matches the output 
after an image mode copy operation. 

NOTE 

The fl option does not copy track of diskettes. However, this 
restriction has no impact on any copy operations if your disk- 
ette was supplied by DIGITAL. 

The following examples use the fl option. The file name A is not significant; it 
is a dummy file name required by the Command String Interpreter. 

*RK:i, !A=M^;Ko;/i: 

RKI!/Cor-y? Are you SLiro?? 

The command shown above copies all blocks from RKO: to RKl:. 

*RK :i. ; A/G : 50 :i. =rko ; / :i: /g : o/i:;: ; 500 

R K :l. J / C afr.ii Are 1:J o i.j ::> u r e ? Y 

The command shown above copies all blocks 0-500 from RKO: to blocks 
501-1000 on RKl:. 

f J K 1 J n ... F' !■■ Y . B A K / 1" = n X : / ;i: 

RKl. ! /Copy » Are you sure'i'Y 

The last command copies device DXO: to RKl: in a file named 
FLOPPY.BAK. 



8.2.3 Bad Block Scan Option (/K) 

Some mass storage volumes (disks, diskettes, DECtape, and DECtape II) 
have bad blocks, or they develop bad blocks as a result of age and use. You 
can use the /K option to scan a device and locate bad blocks on it. DUP prints 
the absolute block number of those blocks on the device that return hardware 
errors when DUP tries to read them. If you specify an output file, DUP prints 
the bad block report in that file. Remember that block numbers are octal and 
the first block on a device is block 0. If DUP finds no bad blocks, it prints an 
informational message. A complete scan of a volume takes from one to several 
minutes depending on the size of the volume. It does not destroy data that is 
stored on the device. 
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*KKOJRTllSJ.SYS/0 
RT-I :ISJ y04.00 



To boot a different monitor, for example the foreground/background monitor 
(for DXO:), type: 

)|(riXO:RT:I.J.FB.SYS/0 

8.2.5 Boot Foreign Volume Option (/Q) 

Use the /Q option with /O to boot a volume that has a monitor other than the 
RT-1 1 version 4 monitor. Note that you must use /Q to boot any version 3B or 
earlier volume of RT-11. The following example boots an RT-11 version 3B 
volume. 

*f\'KO!:/0/R 
RT-:U.SJ V03B-00B 

DUP does not retain the date and time when you use the /Q option. 

8.2.6 Squeeze Option(/S) 

Use the /S option to compress a volume (disk, diskette, DECtape) onto itself 
or onto another disk or DECtape. To do this, DUP moves all the files to the 
beginning of the device, producing a single, unused area after the group of 
files. The squeeze operation does not change the bootstrap blocks of a device. 
The output device you specify, if any, must be an initialized device. If you 
specify an output device, DUP does not query you for confirmation before it 
performs the operation. If you do not specify an output device, DUP prints the 
Are you sure? message and waits for your response before proceeding. You 
must type Y followed by a cari'iage return for the command to be executed. 
Since it is critical to perform an error-free squeeze operation, be sure to scan a 
device (with /K) before you use /S. 

The /S option does not operate on files with .BAD file types, preventing you 
from reusing bad blocks that occur on a disk. You can rename files containing 
bad blocks, giving them a .BAD file type, and therefore cause DUP to leave 
them in place when you execute a /S. During a squeeze operation, files with a 
.BAD file type are renamed FILE. BAD. DUP inserts files before and after 
.BAD files until the space between the last file it moved and the .BAD file is 
smaller than the next file to be moved. If an error occurs during a squeeze 
operation, DUP continues the operation, performing it one block at a time. If 
only one error message prints, you can assume that the operation completed 
correctly. 

The syntax of the command is: 

[output-device = ]input-device/S 

Do not use /S on the system device (SY:) when a foreground or system job is 
loaded. A WUP-F-Can't squeeze SY: while foreground loaded error message 
results if you attempt this, and DUP ignores the /S operation. You must 
unload the foreground job before using the /S option. 
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NOTE 

If you perform a compress operation on the system device, 
the system automatically reboots when the compress oper- 
ation is completed. This operation takes place in order to 
prevent system crashes that can occur when a system file is 
moved. 

You can use /X with /S to suppress the automatic reboot and leave DUI* run- 
ning. However, you should use /X only if you are certain that the monitor 
file will not move. Even then, you should reboot the system when the 
squeeze operation completes if the device handlers have moved. 

The following examples use the /S option: 

*sy:/s 

SY»/S«UGe»z(«» Are hou sure'i'Y 
RT~11SJ V04.00 

The command shown above compresses the files on the system device and 
reboots the system when the compress operation completes. 

NOTE 

If you compress your system volume, make sure DUP pro- 
gram within has the name DUP.SAV. If not, a system fail- 
ure may occur. 

*tiTi:A=DT2:/S 

This command transfers all the files from device DT2: to device DTI:, leav- 
ing DT2: unchanged. The file name A is not significant; it is a dummy file 
name required by the Command String Interpreter. 



8.2.7 Extend Option (/T:n) 

Use the /T option to extend the size of a file. The syntax of the command is: 

filespec = /T:n 

where: 

filespec represents the device, file name, and file type of the file to be 
extended 

n represents the number of blocks to add to the file 

You can extend a file in this manner only if it is followed by an unused area 
at least n blocks long. Any blocks not required by the extend operation 
remain in the unused area. 

The following example uses the /T option: 

*riTi;zYZ.TST^.=/T:ioo 
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This command assigns 100 more blocks to the file named ZYZ.TST on device 
DTI:. 

8.2.8 Bootstrap Copy Option (/U[:xx]) 

In order to use a volume as a system volume, you must copy a bootstrap onto 
it. To do this, first make sure that the appropriate monitor file and handler 
are stored on the volume. For a diskette system, for example, check to see that 
the file DX.SYS is in the diskette directory. If it is, then you can copy the 
desired monitor onto the diskette, using the /U option. The option argument, 
XX, represents a target system device name. Use this argument when you are 
creating a bootable PDT volume if the current system is a PDP-11, and vice 
versa. Also you can use this argument when the current system is on an RX02 
diskette and you wish to create a bootable RXOl diskette. 

NOTE 

When you use the /U option, make sure that the input volume 
is also the output volume. 

To copy a bootstrap for the single-job monitor on RKl:, for example, use the 
following procedure: 

1. Obtain a formatted disk. (Most disks, diskettes, DECtape, and DECtape 
II volumes are formatted by the manufacturer. However, Chapter 18, 
FORMAT, does outline the procedure for reformatting RK05, RK06, 
RK07, RP02, RP03 disks, and RXOl and RX02 diskettes.) 

2. Initialize the disk with /Z (see Section 8.2.12). 

3. Copy files onto the disk. 

4. Copy the monitor and RK05 handler, RK.SYS, onto the disk. 

5. Copy the monitor bootstrap onto the disk with /U. 

The following example shows how to initialize a diskette, copy files to it, and 
write a bootstrap onto the diskette: 

«DX:l, :/z/Y 

The command shown above (step 2 of the procedure described above) initial- 
izes the diskette. 

*Dxi. :a^^=dxo:/s 

This command, which combines steps 3 and 4, squeezes all the files from 
DXO: onto DXl:. 

* nx :l. 5 A-=DXO : RT 1 1 FB . S YS/U 

The last command (step 5) vmtes the bootstrap for the foreground/back- 
ground monitor onto the bootstrap blocks (blocks and 2-5) of DXl:. The file 
name A is not significant; it is a dummy file name required by the Command 
String Interpreter. 

To create a bootable PDT-1 1/150 system diskette while running on a 
PDP-11, specify PD with the AJ option. Likewise, if you are running on a 
PDT-1 1/150, and you wish to create a bootable PDP-11 system diskette, 
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specify DX (for single-density diskette) or DD (for DECtape II) with thie /U 
option. The following command creates a bootable PDT-1 1/150 diskette 
while the current system is on a PDP-11: 

*DXO : A=DXO t RTl IS J . S YS/U : Pti 

The next command creates a bootable PDP-11 diskette while the current 
system is on a PDT-1 1/150: 

*PDO ; A^-FTiO : RTHS J . SYS/U { DX 



8.2.9 Volume ID Option (/V[:ONL]) 

You can use the /V option as an action option to print the volume ID of a 
device or to change the volume ID. The syntax of the command is: 

device:[/Z]/V[:ONL] 

where: 

device: is the device whose volume ID you want to display or change 

If you specify only /V, DUP prints out on the console terminal the volume ID 
and owner name of the device you specify. If you specify /Z with /V, I3UP 
initializes the device and prompts you for a new volume ID and owner name. 
If you specify /Z/V:ONL, DUP assumes you want only to change the volume 
ID and owner name and not initialize the device. 

When you specify either /Z/V or /Z/V:ONL, DUP prompts you for a volume 
ID: 

Volume 111? 

Respond with a volume ID that is up to 12 characters long for a block- 
replaceable device. Terminate your response with a carriage return. DUP 
then prompts for an owner name: 

Owner? 

Respond with an owner name that is up to 12 characters long for a block- 
replaceable device. Terminate your response with a carriage return. DUP 
ignores characters you tsrpe beyond the legal length. You cannot change the 
volume ID of a magtape or cassette without initializing the entire tape. The 
/V:ONL command changes only the volume ID and owner name; it does not 
initialize the device. Section 8.2.12.2 describes how to use /V with the /Z 
option to initialize a device and write new volume identification on it. 

The following example uses the /V:ONL option: 

*RKi:/2:/y:c)Ni... 

RKO J /Volume ID ehan<;ie5 Are aou sure? Y 
yolumc) 111? F'ORTRAN yOl.. 
Owner? Misrc;>:f 

This command writes a new volume ID and owner name on device RKl: , 
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If you specify :RET with /E(, DUP will retain through initialization all 
FILE. BAD files created by a previous /B. 

If you use the /B option to initialize a volume that has been previously initial- 
ized using the /R option, DUP creates FILE. BAD files to cover the bad blocks 
on the volume, and the system then ignores the bad block replacement table. 

If the volume being initialized contains bad blocks, the system prints the 
locations of the bad blocks in octal and in decimal, as in the following 
example: 

*RKO: /2/B 

R K : / I n i t i a 1 i z e i Are you sure ? Y 

B 1 c K Type 

000120 80. Hard 

OOOa?! 313. Hard 

000521 337. Hard 
?DUF'-I-Bad blocKs detected 3. 

The left column lists the locations in octal, and the middle column lists the 
locations in decimal. The right column indicates the type of bad block found: 
hard or soft. 

8.2.12.5 Restoring a Disk (ID) — Use /D to "uninitialize" a volume if you have 
not transferred any files to it since initialization. DUP will restore all files and 
directory entries that were present before the volume was initialized. This 
option is useful if you initiali2;e a volume by mistake. 

Note that /D does not restore boot blocks. Thus, if you use /D to restore a 
previously bootable volume, vise the bootstrap copy option, AJ[:xx], to make 
the volume bootable again. 
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11.3 Input and Output 



Linker input and output is in the form of modules; the linker uses one or 
more input modules to produce a single output (load) module. The linker 
also accepts library modules and symbol table definition files as input, and 
can produce a load map and/or symbol table definition file. The sections that 
follow describe all valid forms of input to and output from the linker. 



1 1 .3.1 Input Object Modules 

Object files, consisting of one or more object modules, are the input to the 
linker. (Entering files that are not object modules may result in a fatal 
error.) Object modules are created by language translators such as the FOR- 
TRAN compiler and the MACRO-11 assembler. The module name item 
declares the name of the object module (see Section 11.3.4). 

The first six Radix-50 characters of the .TITLE assembler directive are used 
as the name of the object module. These six characters must be Radix-50 
characters (the linker ignores any characters beyond the sixth character). 
The linker prints the first module name it encounters in the input file 
stream (normally the main routine of the program) on the second line of the 
map following TITLE:. The linker also uses the first identity label (issued by 
the .IDE NT directive) for the load map. It ignores additional module names. 

The linker reads each object module twice. During the first pass it reads 
each object module to construct a global symbol table and to assign absolute 
values to the program section names and global symbols. The linker uses 
the library files to resolve undefined globals. It places their associated object 
modules in the root. On the second of its two passes, the linker reads the 
object modules, links and relocates the modules, and outputs the load 
module. 

Symbol table definition files are special object files that can serve as input to 
LINK anywhere other object files are allowed. 



11.3.2 Input Library Modules 

The RT-11 linker can automatically search libraries. Libraries consist of 
library files, which are specially formatted files produced by the librarian 
program (described in Chapter 12) that contain one or more object modules. 
The object modules provide routines and functions to aid you in meeting spe- 
cific programming needs. (For example, FORTRAN has a set of modules con- 
taining all necessary computational functions — SQRT, SIN, COS, and so 
on.) You can use the librarian to create and update libraries. Then you can 
easily access routines that you use repeatedly or routines that different pro- 
grams use. Selected modules from the appropriate library file are linked as 
needed with your program to ]5roduce one load module. Libraries are further 
described in Chapter 12. 
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NOTE 

Library files that you combine with the monitor COPY com- 
mand or with the PIP AJ or /B option are invahd as input to 
both the linker and the librarian. 

You specify libraries in a command string in the same way as you specify 
normal modules; you can include them anywhere in the command string. If 
you are creating an overlay structure, specify libraries before you specify the 
overlay structure. Do not specify libraries on the same line as overlay seg- 
ments. If a global symbol is undefined at the time the linker encounters the 
library in the input stream, and if a module is included in the library that 
contains that global definition, then the linker pulls that module from the 
library and links it into the load image. Only the modules needed to resolve 
references are pulled from the library; unreferenced modules are not linked. 

Modules in one library can call modules from another library; however, the 
libraries must appear in the command string in the order in which they are 
called. For example, assume module X in library ALIB calls Y from the BLIB 
library. To correctly resolve all globals, the order of ALIB and BLIB should 
appear in the command line as: 

»Z = B (ALIB ,BLIB 

Module B is the root. It calls X from ALIB and brings X into the root. X in 
turn calls Y, which is brought from BLIB into the root. 

NOTE 

LINK may place a library module in an overlay segment when 
the library module should be in the root. If this occurs you must 
relink using the fl option to avoid invalid results. Examine the 
load map for any library modules located in an overlay seg- 
ment. The global symbols defined in these library modules 
should never be referenced outside of the overlay in which they 
were defined. (Global symbols in an overlay that are externally 
referenced are identified by an "@" sign in the load map.) 
When you relink using fl, respond to the Library search? 
prompt with the names of the symbols designated in the load 
map as externally referenced symbols. LINK then places the 
library module in the root. 

Library Module Processing 

The linker selectively relocates and links object modules from specific user 
libraries that were built by the librarian. Figure 11-1 diagrams this general 
process. During pass 1 the linker processes the input files in the order in which 
they appear in the input command line. If the linker encounters a library file 
during pass 1, it takes note of the library in an internal save status block, and 
then proceeds to the next file. The linker processes only non-library files 
during the initial phase of pass 1. In the final phase of pass 1 the linker 
processes only library files. This is when it resolves the undefined globals that 
were referenced by the non-library files. 
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The linker processes library files in the order in which they appear in the 
input command line. The default system library (SY:SYSLIB.OBJ) is always 
processed last. 

The search method the linker uses allows modules to appear in any order in 
the library. You can specify any number of libraries in a link and they can be 
positioned anywhere, with the exception of forward references between librar- 
ies, and they must come before the overlay structure. The default system 
library, SY:SYSLIB.OBJ, is the last Hbrary file the linker searches to resolve 
any remaining undefined globals. 

Some languages, such as FORTRAN, have an Object Time System (OTS) 
that the linker takes from a library and includes in the final module. The most 
efficient way to accomplish this is to include these OTS routines (such 
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(up to five digits in length) specifying the overlay region to which the module 
is assigned. The /O option must follow (on the same line) the specification of 
the object modules to which it applies, and only one overlay region can be 
specified on a command line. Overlay regions cannot be specified on the first 
command line; that is reserved for the root segment. You must use /C or // for 
continuation. 

You specify co-resident overlay routines (a group of subroutines that occupy 
the overlay region and segment at the same time) as follows: 

*Oi;iJA»OBJByOBJt;/On./C 
*0E(jri.0BJE/0!2/C 



All modules that the linker encounters until the next /O option will be co- 
resident overlay routines. If you specify, at a later time, the /O option with the 
same value you used previously (same overlay region), then the linker opens 
up the corresponding overlay area for a new group of subroutines. This group 
occupies the same locations in memory as the first group, but it is never 
needed at the same time as the previous group. The following commands to 
the linker make R and S occupy the same memory as T (but at different 
times): 

*ma]:n»i,..F'{=root/c 

*RfB/o;i./c; 

*T/o:]. 

The following example establishes two overlay regions. 

>l<OUTF'UTyLP!^^<[NPUT// 
*0B JA/0 : :l. 
*OBJB/0;i 

*OBJc:/o:2 

*0BJD/0:2 

*// 

You must specify overlays in ascending order by region number. For 
example: 

*A=A/C 

*B/o:i/c 
*c/o:i/c 
*D/o:i/c 
*g/d:2 

The following overlay specification is invalid since the overlay regions are not 
given in ascending numerical order. An error message prints in each case, and 
the overlay option immediately preceding the message is ignored. 

*x=libf;;o// 

*LIBRl/0::l 

*LiEiR.?/o:o 

TLINK-U-/C) or /V OF-tion errorj re-enter line 
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In the above example, the overlay line immediately preceding the error mes- 
sage is ignored, and should be re-entered with an overlay region number 
greater than or equal to one. 



11.5.13 Library List Size Option (/P:n) 

The /P:n option lets you change the amount of space allocated for the library 
routine list. Normally, the default value allows enough space for your needs. 
It reserves space for approximately 170 unique library routines, which is the 
equivalent of specifying /P:170. (decimal) or /P:252 (octal). See the RT-11 
Installation and System Generation Guide for details on customizing this 
default number for the library routine list. 

The error message ? LIN K-F -Library list overflow, increase size with IP 
indicates that you need to allocate more space for the library routine list. 
You must relink the program that makes use of the library routines. Use the 
/P:n option and supply a value for n that is greater than 170. 

You can use the /P:n option to correct for symbol table overflow. Specify a 
value for n that is less than 170. This reduces the space used by the library 
routine list and increases the space allocated for the symbol table. If the 
value you choose is too small, the ?LINK-F -Library list overflow, increase 
size with IP message prints. In the following command, the amount of space 
for the library routine list is increased to 300 (decimal). 

*sc(.-;a=rki : sccA/F' s ;?oo . 



11.5.14 Absolute Base Address Option (/Q) 

The /Q option lets you specify the absolute base addresses of up to eight p- 
sects in your program. This option is particularly handy if you are preparing 
your program sections in Absolute Loading format for placement in ROM 
storage. When you use this option in the first command line, the linker 
prompts you for the p-sect names and load addresses. The p-sect name must 
be six characters or less, and the load address must be an even octal number. 
Terminate each line with a carriage return. If you enter only a carriage 
return in response to any of the prompts, LINK ceases prompting. 

If you use /E, /Y, or /U with /Q, LINK processes those options before it proc- 
esses /Q. 

When you use the /Q option, observe the following restrictions: 



• 



Enter only even addresses. If you enter an odd address, no address, or 
invalid characters, LINK prints an error message and then prompts you 
again for the p-sect and load address. 

/Q is invalid with /H or /R. These options are mutually exclusive. 

LINK moves your p-sects up to the specified address; moving down might 
destroy code. If your address requires code to be moved down, LINK 
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The following example creates a new library called NEWLIB.OBJ on the 
default device (DK:). The modules that make up this library file are in the 
files FIRST.OBJ and SECOND. OBJ, both on the default device. 

*NEULI)Ei-FIRST» SECOND 

12.2.4 Inserting Modules into a Library 

Whenever you specify an input file without specifying an associated option, 
the librarian inserts the input file's modules into the library file you name on 
the output side of the command string. You can specify any number of input 
files. If you include section names (by using /P) in the global symbol table and 
if you attempt to insert a file that contains a global symbol or PSECT (or 
CSECT) having the same name as a global symbol or PSECT already existing 
in the library file, the librarian prints a warning message (see Section 12.2.13 
for multiple definition library creation). The librarian does, however, update 
the library file, ignore the global symbol or section name in error, and return 
control to the CSI. You can then enter another command string. 

Although you can insert object modules that exist under the same name (as 
assigned by the .TITLE statement), this practice is not recommended be- 
cause of possible confusion when you need to update these modules (Sections 
12.2.10 and 12.2.11 describe replacing and updating). I 

NOTE 

The librarian performs module insertion, replacement, dele- 
tion, merge, and update when creating the library file. There- 
fore, you must indicate the library file to which the operation is 
directed on both the input and output sides of the command 
line, since effectively the librarian creates a "new" output li- 
brary file each time it performs one of these operations. You 
must specify the library file first in the input field. 

The following command line inserts the modules included in the files 
FA.OBJ, FB.OBJ, and FC.OBJ on DTI: into a library file named DXY- 
NEW.OBJ on the default device. The resulting library also includes the con- 
tents of library DXY.OBJ. 

)|triXYNEW=i:iXY f DTI 5 FA » I- D r FC 

The next command line inserts the modules contained in files THIRD. OBJ 
and FOURTH.OBJ into the library NEWLIB.OBJ. 

*NEWLIB rLIST-NEULIB r THIRD » FOURTH 

Note that the resulting library (1) contains the original library plus some new 
modules, and (2) replaces the original library because the same name was 
used in this example for the input and output library. 
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12.2.5 Delete Option (/D) 

The /D option deletes modules and all their associated global symbols from a 
library file's directory. Since modules are deleted only from the directory (and 
not from the object module itself), all modules that were previously deleted 
are restored whenever you update that library, unless you use /D again to 
delete them. 

When you use the /D option, the librarian prompts: 

Module name? 

Respond with the name of the module to be deleted, followed by a carriage 
return. Continue until you have entered all modules to be deleted. Type a 
carriage return immediately after the Module name? message to terminate 
input and initiate execution of the command line. 

The following example deletes the modules SGN and TAN from the library 
file TRAP.OBJ on DT3:. 

*riT;?:TRAF'=^tiT3:TRAFVi:i 
Module name'!' SGN 
Module naitie? TAN 
Module nsnrie? 

The next example deletes the module FIRST from the library LIBFIL.OBJ; 
all modules in the file ABC. OB J replace old modules of the same name in the 
library; it also inserts the modules in the file DEF.OBJ into the library. 

*L I BF I L=l.. I BF 1 L/n r MfC/K , DEF 
Module name? FIRST 
Module name? 

In the following example, the librarian deletes two modules of the same name 
from the library file LIBFIL.OBJ. 

*LIBFIL=LIBFIL/n 
Module name? X 
Module name? X 
Module name? 



12.2.6 Extract Option (IE) 

The /E option allows you to extract an object module from a library file and 
place it in an .OBJ file. 

When you specify the /E option, the librarian prints: 

Global? 

Respond with the name of the object module you want to extract. If you 
specify a global name, the librarian extracts the entire module of which that 
global is a part. Type a carriage return to terminate the prompting for a 
global. 

You cannot use the /E option on the same command line as another option. 
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Chapter 19 
Error Logging 



The Error Logger utility monitors the hardware reliability of the system. The 
Error Logger keeps a statistical record of all I/O operations that occur on any 
of the following devices: 



DD 


DX 


DL 


DY 


DM 


PD 


DP 


RF 


DS 


RK 


DT 





In addition to keeping these statistics, the Error Logger detects and records 
memory parity or cache errors and any errors that occur during I/O opera- 
tions. At intervals you determine, the Error Logger produces individual and/or 
summary reports on some or all of these errors. The Error Logger is available 
only as a special feature; that is, you must perform the system generation 
process to enable Error Logging. It runs only with the foreground/background 
or extended memory monitors, as either a foreground or system job. 



19.1 Uses 



Error logging reports are useful for maintaining the hardware on which RT-11 
runs. Problems such as line noise, static discharges, or inherently error-prone 
media can cause recoverable er;rors on systems that are otherwise functioning 
normally. By studying error logging reports, you can learn to distinquish these 
errors from those that might be symptoms of an impending device failure. 
Also, some recoverable errors that are insignificant in themselves might be 
related to other more serious errors; their effects might not be immediately 
apparent to you. Information contained in the reports about each error and 
about the status of the system when the error occurred may alert you to a 
previously unforeseen hardwart! problem. 

Sometimes a device fails so quickly that the Error Logger is unable to predict 
failure in time for you to prevent it. In this case, you can determine the cause 
more quickly if a report is available that describes the errors that occurred 
immediately prior to the failure. 

In g(}neral, the Error Logger: 

• Detects each I/O transfer and I/O error as it occurs 

• Gathers information about each I/O transfer or error 

• Stores the information in a file 

• Formats the information to f)roduce a report 
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NOTE 

Because the Error Logger records data on each I/O transfer, 
thereby using additional computer time and memory, you may 
wish to use the Error Logger only when you experience diffi- 
culty with a device. Keeping a backup system volume on which 
the Error Logger is enabled makes this easy. 



19.2 Error Logging Subsystem 

The Error Logger consists of three programs and a statistics file. Whem you 
run the Error Logger, you coordinate these programs to gather I/O and error- 
related information into its statistics file and create the error report you want. 
The Error Logger names the statistics file it creates ERRLOG.DAT. At any 
time you specify, you can direct the Error Logger to create error reports from 
the information it has gathered in ERRLOG.DAT. The names and functions 
of the three Error Logger programs follow. 



EL 



ELINIT 



A foreground or system job that gathers information about every 
I/O transfer and system error and stores it in 
ERRLOG.DAT. The EL job communicates with a device handler 
as each I/O transfer occurs, and it gathers from the handlers all 
the necessary statistics for a complete error report. When .you 
initiate error logging, EL instructs you to start up the second 
Error Logging program, ELINIT. 

A background job that creates and maintains the statistics file, 
ERRLOG.DAT. You can direct ELINIT to initialize 
ERRLOG.DAT every time you have a session at the terminal, or 
you can direct ELINIT to continue compiling statistics in ERR- 
LOG.DAT on a daily basis. 

When you run ELINIT, it prompts you for the information it 
needs to maintain ERRLOG.DAT's size. By default, ELINIT 
allocates 100 decimal blocks for ERRLOG.DAT. Each time you 
run ELINIT, it prints a message that tells how many of those 100 
blocks are filled. IfERRLOG.DAT fills to its limit, the EL job is 
unable to store more information in it. So that you can increase 
ERRLOG.DAT's size, ELINIT prompts you for a file size change 
each time you run the program. 

If you rearrange your RT-11 configuration, or if you do some- 
thing to alter the device handlers, ELINIT may print a message 
indicating that it must initialize ERRLOG.DAT to make the 
statistics it has been maintaining compatible with the new con- 
figuration. When this happens, ELINIT renames the 
ERRLOG.DAT it formerly maintained to ERRLOG.TMP and 
creates a new ERRLOG.DAT. The Error Logger can still create a 
report from ERRLOG.TMP. 
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ERROUT A background job that creates a report from the statistics in 
ERRLOG.DAT or any file of that format. When you run 
ERROUT, you can direct the program to list the error report at 
the terminal or to create a file for the error report. You can also 
indicate whether you want a detailed report on each error that 
occurred or simply a summary report. 

Figure 19-1 provides a diagram of the Error Logging subsystem. 
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Chapter 24 

Source Language Patch Program (SLP) 



The Source Language Patch Program (SLP), is a patching tool you can use 
for maintaining source files that exist on any RT-11 device. 

SLP accepts as input a source file you wish to patch and a command file that 
you create when you compare two source programs using the source com- 
pare program, SRCCOM, described in Chapter 15. When you use SLP along 
with the SRCCOM command file, you can quickly and easily patch one ver- 
sion of a source program to match another version. 

Chapter 15, Source Compare Program (SRCCOM), describes the procedure 
you can use to create a patch command file that is suitable for input to SLP. 

24.1 Calling and Using SLP 

To call SLP from the system device, type the following in response to the 
keyboard monitor dot (.): 

R SU-'CRET::: 

The Command String Interprester prints an asterisk (*) at the left margin of 
the terminal and waits for a (command string. If you enter only a carriage 
return in response to the asterisk, SLP prints its current version number. 
You can type CTRL/C to halt SLP and return control to the monitor when 
SLP is waiting for input from the console terminal. To restart SLP, type R 
SLP or REENTER in response to the monitor's dot. Chapter 6, Command 
String Interpreter, describes the general syntax of the command line that 
SLP accepts. 

Enter a command line according to this general syntax: 

[outfil][,listfil] = infil,comfil/[option...] 

where: 

outfil represents the updated source file. The default file type is 
.MAC 

listfil represents the listing file. When you specify this file, SLP 
creates a numbered listing of the updates SLP made to the 
source file. The default file type is .LST 

infil represents the source file you want SLP to update. The 

default file type is .MAC 
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comfil represents the command file that contains the commands for 
updating the source file. The default file type is .MAC. You 
can create this file by using SRCCOM with the /P option 

/option represents one of the options listed in Table 24-1 

Although either output files can be omitted, you must use one or both. 



24.2 Options 

Table 24-1 lists the options you can use in the command line. 
Table 24-1: SLP Options 



Option 



/A 



/B 
/D 

/L:n 



/P:n 



/S:n 



/T 



Function 



Disables audit trail generation. The audit trail is a string of characters that SLP 
appends to the end of each updated line in the output files. The audit trail keeps 
track of the update status of each line in the output file. You can use the /A option 
if you do not want SLP to use the audit trail in both the updated source file and the 
listing file. 

Inserts spaces instead of tabs between the source line and the audit trail. 

Creates a double-spaced listing. When you use this option, SLP double-spaces 
between the lines in a listing file. 

Specifies the size of the source line, where n represents the maximum number of 
characters you want in the source line. The default buffer size for formatting lintjs' is 
200 (decimal) bytes. If you expect the size of the command lines or source lines to 
be greater than what can fit in the line buffer, you can use this option to change the 
buffer size. SLP interprets the number you specify for n as an octal number; if you 
enter a decimal number, use a decimal point. The line buffer must be as least as 
long as the sum of the column number where the audit trail begins and the'number 
of characters in the audit trail. 

Specifies the start column of the audit trail, where n represents the column number 
in which you want the audit trail to start. If the number you specify for n is 
decimal, be sure to use a decimal point after the number. By default, SLP starts 
the audit trail in column 73 (decimal). If a source line extends beyond the column 
where the audit trail begins, the audit trail can overstrike the source line. If you use 
the /P:n option, you start the audit trail in any tab stop column. SLP rounds up the 
number you specify to the nearest tab stop column. If, for example, you specify 46 
for n, SLP rounds this number to 49. 

Specifies size of the audit trail, where n represents the number of characters you 
want in the audit trail. If the number you specify is decimal, be sure to use a 
decimal point after the number. The default number of characters in the audit trail 
is 12 (decimal). The maximum number of characters you can specify for the audit 
trail is 16 (decimal). 

Retains trailing blanks and tabs in the input source file. By default, SLP removes 
spaces and tabs that appear at the end of lines in the input source file. 
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24.3 Example 



This section uses SLP to patcli the source file, ANTONY.MAC, so that it 
matches the source file CAESAR.MAC. CAESAR.MAC consists of the fol- 
lowing lines. 



P"R:tENDS» FilOMANSy COUNTRYMEN! 

LENti ME YOUR EARS! 

:i: COME TO BURY CAESAR y 

NOT TO PRAISE HIM. 

THE EVIL THAT MEN DO 

LIMES AFTER THEM. 

THE GOOD IS OFT INTERRED 

WITH THEIR bones; 

SO LET IT BE WITH CAESAR! 



The file this example will patch, ANTONY.MAC, follows. 



FRIENBSt ROMANSr COUNTRYMEN! 

LEN ME YOUR EARS! 

I COME TO BURY CAESAR >■ 

NOT TO PRAISE HIM. 

THE EVIL THAT MAN DO 

LIVES AFTER THEM. 

THE GOOD IS OFT ENTERED 

WIT THEIR HOMES? 

SO LET IT BE WITH CAESAR! 

Using the /P option in SRCCOM, this example obtains a command file, CAE- 
SAR. DIF. CAESAR. DIF contains the necessary commands to make 
ANTONY.MAC match CAESAR.MAC. The following command line directs 
SLP to patch ANTONY.MAC so that it matches CAESAR.MAC. 

.R SLP 

* ANTONY » ANTONY==ANTONY , CAESAR 

After executing the command above, SLP assigns a .BAK file type to the 
input file ANTONY.MAC. It assigns .MAC file type to the updated source 
file. SLP has also created a listing of ANTONY.MAC that lists each line by 
number and appends an audit trail to each new line. The updated file, 
ANTONY.MAC, is now identical to CAESAR.MAC. ANTONY.LST appears 
below. 

SLP V04 . 00 ANTONY i. ANTONY=ANTONY . MAC » CAESAR » DIF 



V04.I 


00 ANTONY »|i 


i|NTONY=ANTONY 


1. 


FRIENDS T ROMANS » COUNTRYMEN! 


yXtJKNEW** 


2. 


LEND ME YOUR EARS! 


iiX!*-:!. 


3. 


I COME TO BURY CAESAR y 




4. 


NOT TO PRAISE HIM. 


PHoKNEW** 


5. 


THE EVIL THAT MEN DO 


S**-], 


6. 


LIVES AFTER THEM. 


S**NEW** 


7. 


THE ROOD IS OFT INTERRED 


i!*)KNEW)|<)K 


S. 


WITH THEIR BONES P 


5**- ■2 


9. 


SO LET IT BE WITH CAESAR! 





Note that when SLP updates a line, it appends an additional audit trail 
below the audit trail of the updated line. The additional audit trail keeps 
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track of the number of consecutive lines that have been updated. In 
ANTONY.LST, above, note the audit trails ;**-! and ;**-2. 

24.4 Creating and Maintaining a Command Fiie 

SLP is a line-oriented patching tool. That is, you make changes to entire lines, 
and not to individual or strings of characters within a line. If you want to 
change only a few characters within a line, it will be necessary for you to enter 
a new line. 

Although DIGITAL recommends you use the SRCCOM /P option to create 
the SLP input command file, you can use any RT-11 editor to create it 
yourself. The section that follows describes the commands, or operators, you 
use to create the command file. This procedure is tedious, however, and in 
most cases unnecessary. But for completeness, this procedure is included with 
this chapter. Table 24-2 lists the commands, or operators, you enter into the 
command file. 

The section ends with a description of various line manipulations that SLP 
can effect. 

Table 24-2: SLP Command File Operators 



Operator 



Explanation 



% 
I 



Indicates the start of an update. 

Disables the audit trail. Note that this operator must appear on a line by itself. 
If it appears in the first column of a line with additional information following 
it, the audit trail will be disabled, but the rest of the command line will be 
ignored. If used in any column other than column one, a syntax error occurs. 

Enables the audit trail. 

Indicates the end of an update or series of updates; it appears as the last 
character in the command file. 

Serves as an escape character for characters SLP would otherwise interpret as 
operators. For example, if you want to include a slash (/) in a source file, type 
the less-than character (<) before the slash. Then, SLP will not interpret the 
slash as an operator. You can use the less-than character as an escape charac- 
ter for all SLP command file operators. 



24.4.1 Update Line Format 

The general format of the SLP command file update line follows. 

-locatorl, [locator2] , [/audit trail/] [;] 
input line 



where: 



indicates that this is an update line 
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locatorl represents a character string that serves as a line locator. 
SLP moves the line pointer to the line specified by the line 
locator. You can specify this line locator with any of the 
locator forms described below 

locator2 represents a character string that, when used with locat- 
orl, defines a range of lines you want to delete or replace. 
You can specify this line locator with any of the locator 
forms described below. You cannot define a range of lines 
in a backwards direction; the line referenced by locator2 
must occur in the source file after the line referenced by 
locatorl 

/audit trail/ represents a character string you use as an audit trail. SLP 
appends the audit trail to the right of each updated line. 
You must delimit the audit trail with slashes (/) 

inputline represents a line of new text that SLP inserts into the file 
immediately following the current line. You can enter as 
many input lines as you want 

; is an optional command line terminator 

All fields in the update line are positional. That is, if you specify only locatorl 
and an audit trail, you must use two commas between those two fields. If you 
want to specify only the audit trail, you must precede the audit trail with two 
commas. 

The update lines in a command file must edit the source file in a forwards 
direction, from beginning to end. Each locatorl must point to a line that 
appears in the source file before the lines pointed to by any succeeding 
locatorl. 

The line locators can take one of the following forms: 

/string/[+n] 
/string. . .string/[+n] 
number[+n] 
.+n 



where: 



/string/[+n] represents an ASCII character string. You must 

delimit any string you enter with slashes. SLP lo- 
cates the first occurrence of this string, and moves 
the line pointer to the line that contains that 
string. +n represents the offset from the line that 
contains the string. You must use the plus charac- 
ter (+) with the n notation 

/string... string/[+n] represents an ASCII character string. SLP locates 
the line in which the two strings delimit a larger 
string. Use the ellipsis (...) in this locator form to 
separate the two strings. +n represents the offset 
from the line specified by the string... string locator 
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number[+n] 



.+n 



represents the line number to which SLP is to 
move the line pointer. +n represents the offset from 
the line specified by number 

represents the offset from the current line pointer. 
SLP interprets the period (.) as the current Une 
pointer location, and the +n as the offset from it. 
You must use the plus character (+) 



24.4.2 Creating a Numbered Listing 

You can use SLP to create a numbered listing of the input source file. In 
creating a command file, you should use a numbered listing when you prepare 
command input. To generate a numbered listing, enter the following lines: 

R SLP 

* > 1. i <s t f :i. let ■■■■■■■■ i n f ,i. :i, e 

Listfile represents the listing file SLP produces, and infile represents the 
input source file. Here is a file, PROG. MAC, from which SLP is to create a 
numbered listing: 

.title: pfjog.mac yERsroN i 

.MCALL .TTYOUTv .EXTTr .PRINT 



EXP : 



.PFiINT ♦MESS AG 



MCW 

FIRST} MOy 

MOV 



*N»R5 

*N+:LfRO 

*Ai.Rl 



The following command Hne creates a numbered listing, PROG.LST of the 
file above, PROG.MAC: 



* , PRC)(;^^=PRC)G 



After SLP processes the command above, it produces the following listing of 
PROG.MAC: 



SLP V04.00 

:l. , 



exp: 
first: 



cPRtlG=PRC)G.MA(:; 
.title PROG.MAC VERSION 1 
.MCALL .TTYOUT» .EXIT» .PRINT 



.PRINT 
MOV 
MOV 
MOV 



♦MESSAD 
*N>.R5 

♦ NHyRO 

♦ A»R1 



24.4.3 Adding Lines to a File 

To add lines to a file, enter in the command file one of the three locator forms 
below: 

■nuiiiber 

. I" ) ri.l > > E/audittrsi l/J 
• /str:i.n<.=i/ 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 
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